فوری آغاز

تین درخواستوں سے ویڈیو کا لنک ایک ٹرانسکرپٹ فائل تک پہنچ جاتا ہے۔ آپ کو ایک API کی درکار ہے: اسے API کیز صفحے پر بنائیں۔ یہ ایک بار دکھائی جاتی ہے۔ ہر اکاؤنٹ کو ہر مہینے 50 مفت کریڈٹس ملتے ہیں۔

1. لنک جمع کریں#

mode: "captions_only" ویڈیو کے کیپشن 1 کریڈٹ میں دیتا ہے اور ہر پلان پر کام کرتا ہے، مفت ٹرائل سمیت۔ کسی پیڈ پلان پر، جب ویڈیو میں کیپشن نہ ہوں تو mode: "auto" بھیجیں تاکہ AI ٹرانسکرپشن استعمال ہو (شروع ہونے والے ہر منٹ کے 2 کریڈٹس)۔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 سیکنڈ تک روکے رکھتا ہے اور کام ختم ہوتے ہی جواب دیتا ہے۔ کیپشن عموماً چند سیکنڈ میں تیار ہو جاتے ہیں؛ AI ٹرانسکرپشن میں ویڈیو کی لمبائی کا تقریباً ایک چوتھائی وقت لگتا ہے۔ اگر 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 فارمیٹ میں ایکسپورٹ کریں (مکمل متن، وقت کے ساتھ حصے، اور AI ٹرانسکرپشن کے لیے ہر لفظ کا وقت)۔ ایکسپورٹ مفت ہیں اور ان کی کوئی حد نہیں۔

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
یہ ایک مثال ہے
 
2
00:00:02,400 --> 00:00:04,900
اس میں دو لائنیں ہیں

اگلے قدم#

• وہی لنک دوبارہ جمع کرانا مفت ہے: محفوظ شدہ نتیجہ واپس آ جاتا ہے۔
• ایک ساتھ کئی ویڈیوز: بیچ، ہر درخواست میں آپ کے پلان کے بیچ سائز تک۔
• اپنی فائلیں: اپلوڈز۔
• بار بار پوچھنے کی ضرورت نہیں: ویب ہکس کام ختم ہونے پر آپ کے سرور کو اطلاع بھیجتے ہیں۔
• Claude، Cursor یا کسی اور AI ایجنٹ سے: MCP۔