Snelstart

Met drie verzoeken zet je een videolink om in een transcriptiebestand. Je hebt een API-sleutel nodig: maak er een aan op de pagina API keys. Hij wordt maar één keer getoond. Elk account krijgt elke maand 50 gratis credits.

1. Stuur een link in#

mode: "captions_only" geeft de ondertitels van de video terug voor 1 credit en werkt op elk abonnement, ook op de gratis proef. Stuur op een betaald abonnement mode: "auto" als een video geen ondertitels heeft. Dan schakelt het over op AI-transcriptie (2 credits per begonnen minuut). De Idempotency-Key is een tekst van 8 tot 128 tekens die je zelf kiest. Als je dezelfde sleutel opnieuw stuurt, krijg je dezelfde taak terug in plaats van een tweede.

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. Wacht tot het klaar is#

?wait=25 houdt het verzoek maximaal 25 seconden open en geeft een antwoord zodra de taak klaar is. Ondertitels zijn meestal in enkele seconden klaar; AI-transcriptie duurt ongeveer een kwart van de lengte van de video. Als status nog niet succeeded, failed of cancelled is, stuur het verzoek opnieuw.

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. Haal de transcriptie op#

result_id is de transcriptie. Exporteer die als txt, srt, vtt of json (volledige tekst, getimede segmenten en woordtijden bij AI-transcriptie). Exports zijn gratis en onbeperkt.

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
Welkom bij deze video
 
2
00:00:02,400 --> 00:00:04,900
Vandaag bekijken we hoe het werkt

Wat hierna#

• Dezelfde link opnieuw indienen is gratis: het opgeslagen resultaat wordt teruggegeven.
• Veel video's tegelijk: batches, tot de batchgrootte van je abonnement per verzoek.
• Je eigen bestanden: uploads.
• Geen polling: webhooks roepen je aan zodra een taak klaar is.
• Vanuit Claude, Cursor of een andere AI-agent: MCP.