# استخدم youtube transcript api حتى إذا لم تتوفر ترجمة نصية

> أرسل رابطا إلى youtube transcript api لتحصل على JSON أو TXT أو SRT أو VTT؛ الترجمة النصية أولا وإلا الذكاء الاصطناعي، بوحدة رصيد للدقيقة.

Canonical: https://transcript1.com/ar/features/youtube-transcript-api
Language: ar
Last updated: 2026-10-19

استخدم youtube transcript api لجلب نص الفيديو بصيغة JSON أو TXT أو SRT أو VTT. أرسل الرابط فقط؛ نأخذ الترجمة النصية المتاحة، وإن لم نجد مسارا مناسبا نفرغ الصوت بالذكاء الاصطناعي.

- الترجمة النصية أولا، والذكاء الاصطناعي عند الحاجة
- وحدة رصيد لكل دقيقة في الحالتين
- روابط watch وyoutu.be وShorts وembed

## اختر مصدر النص الذي يحتاجه تطبيقك

### لا حاجة لتعديل رابط الفيديو

نقبل روابط watch وyoutu.be وShorts وembed وlive، مع www أو بدونه. كلها تحدد الفيديو نفسه.

### الأولوية لما نشره صانع المحتوى

مع source=auto نختار الترجمة النصية التي رفعها صانع المحتوى قبل المنشأة تلقائيا. لا نستخدم المسارات المترجمة آليا إلى لغة أخرى.

### غياب الترجمة النصية لا يوقف العمل

إذا لم يتوفر مسار مناسب نفرغ الصوت. ولتفريغ التسجيل من الصوت دائما، حتى مع وجود ترجمة نصية، اختر source=stt.

### اعرف من أين جاء النص

يوضح transcript_source المصدر المستخدم؛ youtube_captions للترجمة النصية، أو speech_to_text للتفريغ من الصوت.

### السعر لا يتغير باختلاف المصدر

كل دقيقة من مدة الفيديو تستهلك وحدة رصيد، مع تقريب المدة إلى الدقيقة الأعلى. إذا فشل التفريغ أو ألغيته، فلن نخصم من رصيدك.

## أرسل الرابط واحفظ معرف التفريغ

أنشئ مفتاح API من لوحة التحكم، ثم أرسل رابط الفيديو عبر POST من خادمك أو سكربت Python. يتيح wait=60 الانتظار حتى 60 ثانية. راجع [حقول الطلب وحالات الاستجابة](https://transcript1.com/ar/docs/api-reference#create-a-transcription) قبل الربط.

احفظ المعرف بمجرد نجاح الطلب. إذا انتهى الانتظار ولم يجهز النص، تابع عبر GET /v1/transcriptions/:id. التفريغ مستمر؛ لا ترسل طلب إنشاء آخر لمجرد أن اتصال HTTP انتهى.

قد تظهر الحالات queued ثم fetching ثم transcribing. عند completed اقرأ النص، وعند failed تعامل مع الخطأ. لا تعرض نصا فارغا على أنه تفريغ ناجح إذا تأخر الاتصال أو تعذر جلب الفيديو.

### cURL

```
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"youtube","url":"https://youtu.be/dQw4w9WgXcQ"}'
```

## احتفظ بحقل transcript\_source مع النص

توضح الاستجابة مصدر النص ونوع الترجمة النصية إن استخدمت. ويعرض billed_minutes مدة الفيديو بعد التقريب إلى الدقيقة الأعلى. تجد الحقول كاملة في [مرجع كائن التفريغ](https://transcript1.com/ar/docs/api-reference#the-transcription-object).

احفظ transcript_source وcaption_kind إذا كان توثيق المصدر مهما لتطبيقك. تحتفظ الترجمة النصية التي رفعها صانع المحتوى بصياغتها المنشورة، دون توقيت لكل كلمة. أما المنشأة تلقائيا فتقدم بداية كل كلمة، والتفريغ من الصوت يقدم البداية والنهاية ودرجة الثقة.

لكل مقطع وقت بداية ونهاية بالثواني. استخدمهما لربط النص بالتشغيل أو بالملاحظات. اطلب include=words فقط إذا احتجت بيانات الكلمات الإضافية. مثال JSON أدناه يشرح بنية الاستجابة، ولا ينقل كلام الفيديو المستخدم في الطلب.

### استجابة JSON مختصرة

```
{
  "id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "status": "completed",
  "transcript_source": "youtube_captions",
  "caption_kind": "auto_generated",
  "language": "en",
  "billed_minutes": 4,
  "transcript": {
    "text": "Welcome back to the channel. Today we are looking at how transcripts are made.",
    "segments": [
      { "start": 0, "end": 4.2, "speaker": null, "language": "en", "text": "Welcome back to the channel." }
    ]
  }
}
```

## هل تحتاج المسار المنشور أم تفريغا من الصوت؟

الإعداد الافتراضي هو source=auto. اختر captions (الترجمة النصية فقط) إذا كنت تحتاج المسار المنشور وحده؛ إن غاب سيظهر no_captions دون خصم رصيد. واختر stt لتفريغ الصوت دائما. راجع [خيارات المصدر](https://transcript1.com/ar/docs/sources-and-options#source) قبل الجمع بينها.

تمييز المتحدثين يحتاج إلى الصوت. لذلك ينتقل auto مع diarize=true إلى التفريغ بالذكاء الاصطناعي حتى مع وجود ترجمة نصية. أما جمع diarize=true مع captions فيرفض الطلب؛ لن نتجاهل أحد الخيارين بصمت.

تؤثر language أيضا في اختيار المسار. يجب أن يطابق اللغة المطلوبة، أو لغة الفيديو الأصلية عند الاختيار التلقائي. لا نستخدم ترجمة آلية إلى لغة أخرى، وتحديد لغة للتفريغ الصوتي لا يحول API إلى أداة ترجمة.

### طلب التفريغ من الصوت

```
{
  "platform": "youtube",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "source": "stt"
}
```

## افهم الخطأ قبل إعادة الإرسال

الفيديو الخاص أو المقيد بالعمر أو البث الجاري يحتاج إلى مصدر آخر، لا إلى تكرار المحاولة. ومع no_captions قرر إن كان التفريغ من الصوت مناسبا لك. أما التفريغ الذي لا يزال جاريا فتابعه بمعرفه. يوضح [مرجع الأخطاء](https://transcript1.com/ar/docs/errors) الحالات التي ينبغي أن يعالجها تطبيقك.

إذا اضطررت إلى إعادة طلب الإنشاء، اتبع قواعد [Idempotency-Key](https://transcript1.com/ar/docs/api-reference#idempotency). إعادة استخدام تفريغ حديث خيار منفصل يطابق الفيديو والإعدادات. وجود نص مخزن مؤقتا لا يعني أن إنشاء مهمة جديدة مجاني؛ قراءة تفريغ مكتمل بمعرفه لا تستهلك دقائق.

يمكن للطلب نفسه قبول روابط منصات أخرى مثل [TikTok](https://transcript1.com/ar/features/tafrigh-fidyu-tiktok) و[Instagram](https://transcript1.com/ar/features/tafrigh-reels-instagram). تدعم YouTube وX وTikTok وBluesky مسارات ترجمة نصية مع التفريغ من الصوت عند الحاجة. تحقق من [قدرات كل مصدر](https://transcript1.com/ar/docs/sources-and-options) بدلا من إتاحة تركيبات لا تدعمها المنصة.

## الأسئلة الشائعة

### هل يعمل مع فيديو لا يحتوي على ترجمة نصية؟

نعم. مع source=auto نفرغ الصوت إذا لم نجد مسار ترجمة نصية مناسبا. إذا أردت التوقف بدلا من استخدام الذكاء الاصطناعي، اختر source=captions.

### أي رابط يمكنني إرساله؟

روابط watch وyoutu.be وShorts وembed وlive. رابط القناة أو قائمة التشغيل وحدها لا يحدد فيديو، ويعيد 422 invalid_url.

### هل يمكن تفريغ فيديو خاص؟

لا. نقبل الفيديو العام أو غير المدرج. لا يمكن جلب الفيديو الخاص أو المقيد بالعمر أو البث الجاري. إذا كان التسجيل ملكك، ارفع الملف بدلا من الرابط.

### كم يستهلك الفيديو من الرصيد؟

وحدة رصيد لكل دقيقة، مع تقريب المدة إلى الدقيقة الأعلى، سواء استخدمنا الترجمة النصية أو الذكاء الاصطناعي. تحصل عند تأكيد بريدك على 60 دقيقة مجانية مرة واحدة، دون بطاقة.

### هل هذه مكتبة youtube-transcript-api في Python؟

لا. transcript1 هو REST API مستضاف. لاستخدامه من Python أرسل طلب HTTP مع مفتاح API الخاص بك.

## اقرأ أيضا

- [الطوابع الزمنية وملفات SRT وVTT](https://transcript1.com/ar/features/insha-malaf-srt)
- [API لملفات الصوت والفيديو](https://transcript1.com/ar/features/speech-to-text-api)
- [إشعارات webhook](https://transcript1.com/ar/features/webhook-tafrigh-sawti)
- [إعادة استخدام المحتوى](https://transcript1.com/ar/use-cases/tahwil-alfidyu-ila-maqal)