واجهة YouTube API
واجهة API لنصوص YouTube ترجمات المنشئ أولًا، موقوتة لكل مقطع
نقطة نهاية واحدة لفيديوهات YouTube وShorts. تأتي ترجمات المنشئ أولًا، وموقوتة لكل مقطع.
1.0الإمكانات
المزايا الأساسية والحدود المرتبطة بها
استخرج ترجمات المنشئين من فيديوهات YouTube وShorts كمقاطع موقوتة، مع التفريغ بالذكاء الاصطناعي في الخطط المدفوعة للفيديوهات التي لا تحتوي على ترجمات.
الحدود التشغيلية والشفافية
- بنية تحتية في منطقة واحدة منشورة في 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 ويُفرَّغ كلاهما.
