> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# تحويل الكلام إلى نص

> فرِّغ ملفات الصوت باستخدام نماذج تحويل الكلام إلى نص في Venice عبر نقطة النهاية المتوافقة مع OpenAI /audio/transcriptions.

يقوم تحويل الكلام إلى نص بتفريغ الصوت المنطوق إلى نص مكتوب. أرسل ملف صوت إلى `/audio/transcriptions`، واختر نموذج تفريغ، وحدّد صيغة الاستجابة التي تريدها.

## الاستخدام الأساسي

<CodeGroup>
  ```python Python theme={"system"}
  import os

  import requests

  with open("meeting.mp3", "rb") as audio:
      response = requests.post(
          "https://api.venice.ai/api/v1/audio/transcriptions",
          headers={"Authorization": f"Bearer {os.environ['VENICE_API_KEY']}"},
          files={"file": audio},
          data={
              "model": "nvidia/parakeet-tdt-0.6b-v3",
              "response_format": "json",
          },
      )

  response.raise_for_status()
  print(response.json()["text"])
  ```

  ```javascript Node.js theme={"system"}
  import { createReadStream } from "node:fs";
  import FormData from "form-data";

  const form = new FormData();
  form.append("file", createReadStream("meeting.mp3"));
  form.append("model", "nvidia/parakeet-tdt-0.6b-v3");
  form.append("response_format", "json");

  const response = await fetch("https://api.venice.ai/api/v1/audio/transcriptions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
      ...form.getHeaders(),
    },
    body: form,
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const transcript = await response.json();
  console.log(transcript.text);
  ```

  ```bash cURL theme={"system"}
  curl https://api.venice.ai/api/v1/audio/transcriptions \
    -H "Authorization: Bearer $VENICE_API_KEY" \
    --form file=@meeting.mp3 \
    --form model=nvidia/parakeet-tdt-0.6b-v3 \
    --form response_format=json
  ```
</CodeGroup>

## المدخلات المدعومة

تشمل صيغ الصوت الشائعة `mp3` و`mp4` و`mpeg` و`mpga` و`m4a` و`wav` و`webm` و`flac` و`ogg`. راجع صفحة [نماذج تحويل الكلام إلى نص](/models/speech-to-text) لمعرفة دعم النماذج الحالي والأسعار.

## صيغ الاستجابة

| الصيغة         | استخدمها عندما                                           |
| -------------- | -------------------------------------------------------- |
| `json`         | تريد استجابة بسيطة على شكل `{ "text": "..." }`.          |
| `text`         | تريد نصًا خالصًا دون الحاجة إلى تحليل JSON.              |
| `srt`          | تحتاج إلى ترجمات بصيغة SubRip.                           |
| `vtt`          | تحتاج إلى ترجمات بصيغة WebVTT.                           |
| `verbose_json` | تحتاج إلى بيانات وصفية أغنى عن الطوابع الزمنية والمقاطع. |

<Tip>
  استخدم صيغ الترجمة عندما يُقرن التفريغ بتشغيل الوسائط. استخدم `json` أو `text` عندما يغذّي التفريغ التلخيصَ أو البحث أو مطالبات المحادثة اللاحقة.
</Tip>

## نصائح الإنتاج

* حافظ على وضوح الصوت وتجنّب تداخل المتحدثين عند الإمكان.
* قسّم التسجيلات الطويلة جدًا إلى أجزاء أصغر إذا كان سير عملك يتطلب زمن استجابة أقل أو محاولات إعادة أسهل.
* خزّن مسار الصوت الأصلي، ومعرّف النموذج، وصيغة الاستجابة مع كل تفريغ لأغراض التدقيق.

## موارد ذات صلة

* [واجهة برمجة تطبيقات تفريغ الصوت](/api-reference/endpoint/audio/transcriptions)
* [نماذج تحويل الكلام إلى نص](/models/speech-to-text)
* [دليل تحويل النص إلى كلام](/guides/media/text-to-speech)