क्विकस्टार्ट

तीन अनुरोध एक वीडियो लिंक को ट्रांसक्रिप्ट फ़ाइल तक पहुंचा देते हैं। आपको एक 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
Never gonna give you up
 
2
00:00:02,400 --> 00:00:04,900
Never gonna let you down

आगे क्या#

• वही लिंक दोबारा सबमिट करना मुफ़्त है: सहेजा हुआ नतीजा लौटा दिया जाता है।
• एक साथ कई वीडियो: बैच, हर अनुरोध में आपके प्लान के बैच आकार तक।
• अपनी फ़ाइलें: अपलोड।
• पोलिंग के बिना: जॉब पूरा होने पर वेबहुक आपको कॉल करते हैं।
• Claude, Cursor या किसी और AI एजेंट से: MCP।