البدء السريع

ثلاثة طلبات تحوّل رابط فيديو إلى ملف نص مفرّغ. تحتاج إلى مفتاح API: أنشئه من صفحة مفاتيح API. يُعرض المفتاح مرة واحدة فقط. يحصل كل حساب على 50 رصيدًا مجانيًا كل شهر.

1. أرسل رابطًا#

mode: "captions_only" يعيد ترجمات الفيديو برصيد واحد، ويعمل في كل الخطط بما فيها التجربة المجانية. في الخطة المدفوعة، أرسل mode: "auto" ليلجأ الطلب إلى التفريغ بالذكاء الاصطناعي عندما لا تكون للفيديو ترجمات (رصيدان لكل دقيقة مبدوءة). و Idempotency-Key سلسلة من 8 إلى 128 حرفًا تختارها أنت. فإعادة إرسال المفتاح نفسه تعيد المهمة نفسها بدلًا من إنشاء مهمة ثانية.

curl -X POST https://www.transcriptdock.com/v1/jobs \
  -H "Authorization: Bearer td_live_YOUR_KEY" \
  -H "Idempotency-Key: my-first-job" \
  -H "Content-Type: application/json" \
  -d '{ "source": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, "mode": "captions_only" }'

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "queued",
  "stage": "resolve",
  "result_id": null,
  "error": null,
  "billing": { "credits_reserved": 1, "credits_charged": 0, "kind": "captions" },
  "source": { "platform": "youtube", "media_id": "dQw4w9WgXcQ", "canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

2. انتظر النتيجة#

?wait=25 يُبقي الطلب مفتوحًا حتى 25 ثانية، ويعود فور انتهاء المهمة. تستغرق الترجمات عادةً بضع ثوانٍ، أما التفريغ بالذكاء الاصطناعي فيستغرق نحو ربع مدة الفيديو. إذا كانت status ما زالت ليست succeeded أو failed أو cancelled، فاستدعِ الطلب مرة أخرى.

curl "https://www.transcriptdock.com/v1/jobs/11111111-1111-4111-8111-111111111111?wait=25" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "succeeded",
  "stage": null,
  "result_id": "22222222-2222-4222-8222-222222222222",
  "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": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

3. احصل على النص المفرّغ#

result_id هو النص المفرّغ. صدّره بصيغة txt أو srt أو vtt أو json (النص الكامل، والمقاطع المرتبطة بالتوقيت، وتوقيتات الكلمات للتفريغ بالذكاء الاصطناعي). والتصدير مجاني وغير محدود.

curl "https://www.transcriptdock.com/v1/transcripts/22222222-2222-4222-8222-222222222222/export?format=srt" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

1
00:00:00,000 --> 00:00:02,400
Never gonna give you up
 
2
00:00:02,400 --> 00:00:04,900
Never gonna let you down

الخطوات التالية#

• إعادة إرسال الرابط نفسه مجانية: تُعاد النتيجة المحفوظة.
• عدة فيديوهات دفعة واحدة: الدفعات، حتى حجم الدفعة المسموح به في خطتك لكل طلب.
• ملفاتك الخاصة: رفع الملفات.
• بدون استعلام متكرر: Webhooks تستدعيك عند انتهاء المهمة.
• من Claude أو Cursor أو أي وكيل ذكاء اصطناعي آخر: MCP.