انتقل إلى المحتوى
Transcript Dock
تسجيل الدخولابدأ مجانًا

قائمة الموقع

Transcript Dock
واجهة YouTube API

واجهة API لنصوص YouTube ترجمات المنشئ أولًا، موقوتة لكل مقطع

نقطة نهاية واحدة لفيديوهات YouTube وShorts. تأتي ترجمات المنشئ أولًا، وموقوتة لكل مقطع.

1.0الإمكانات

المزايا الأساسية والحدود المرتبطة بها

استخرج ترجمات المنشئين من فيديوهات YouTube وShorts كمقاطع موقوتة، مع التفريغ بالذكاء الاصطناعي في الخطط المدفوعة للفيديوهات التي لا تحتوي على ترجمات.

  1. ترجمات المنشئ أولًا

    عندما يحتوي الفيديو على ترجمات منشورة، تُقرأ مسارات المنشئ مباشرةً دون تنزيل الصوت ودون رسوم التفريغ بالذكاء الاصطناعي.

  2. روابط المشاهدة والمشاركة وShorts

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

  3. توقيت المقاطع والكلمات

    تُوقَّت مسارات الترجمات لكل مقطع. ويعيد التفريغ بالذكاء الاصطناعي توقيت الكلمات، فيمكنك قص المقاطع ومزامنة الجداول الزمنية.

  4. تصديرات منظمة بعدة صيغ

    صدّر نتائج JSON موحدة، أو نزّل ملفات الترجمات القياسية SRT وWebVTT بتنسيق متسق.

الحدود التشغيلية والشفافية

  • بنية تحتية في منطقة واحدة منشورة في us east.
  • التسعير: رصيد واحد لكل نص ترجمات، ورصيدان عن كل دقيقة تُبدأ من التفريغ بالذكاء الاصطناعي، من رصيد واحد مشترك.
  • أقصى مدة للوسائط ساعتان (7,200 ثانية) لكل مصدر.
2.0التنفيذ

الطلب والاستجابة الطلب الدقيق وما يعود منه

POST/v1/jobs

curl -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer td_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"source": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
},
"mode": "captions_only",
"caption_preference": "prefer_creator"
}'

نتيجة المهمة

{
"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b",
"status": "succeeded",
"stage": null,
"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f",
"error": null,
"billing": {
"credits_reserved": 0,
"credits_charged": 1,
"kind": "captions"
},
"source": {
"platform": "youtube",
"media_id": "dQw4w9WgXcQ",
"canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"title": "Sample YouTube Video",
"upload_id": null
},
"options": {
"mode": "captions_only",
"language": null,
"caption_preference": "prefer_creator"
},
"created_at": "2026-09-12T14:32:00Z"
}
3.0أسئلة

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

ما الذي يحدث مع الترجمات والتفريغ بالذكاء الاصطناعي والحدود لهذا المصدر.

كيف تتعامل واجهة API مع الفيديوهات التي لا تحتوي على ترجمات مغلقة؟

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

هل يمكنني طلب الترجمات فقط لتجنب رسوم التفريغ بالذكاء الاصطناعي؟

نعم. ضبط الوضع على captions_only يضمن عدم تشغيل أي مسار للتفريغ بالذكاء الاصطناعي، فتبقى تكلفة الاستخراج متوقعة ومنخفضة.

هل تُدعم فيديوهات YouTube Shorts؟

نعم. تُوحَّد روابط youtube.com watch وروابط youtube.com/shorts ويُفرَّغ كلاهما.