Snabbstart

Tre förfrågningar tar en videolänk till en transkriptfil. Du behöver en API-nyckel: skapa en på sidan API-nycklar. Den visas bara en gång. Varje konto får 50 gratiskrediter varje månad.

1. Skicka in en länk#

mode: "captions_only" returnerar videons undertexter för 1 kredit och fungerar på alla abonnemang, även under den gratis provperioden. På ett betalt abonnemang kan du skicka mode: "auto" för att falla tillbaka till AI-transkribering när en video saknar undertexter (2 krediter per påbörjad minut).Idempotency-Key är en valfri sträng på 8 till 128 tecken som du själv väljer. Om du skickar samma nyckel igen får du samma jobb i stället för ett nytt.

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. Vänta på jobbet#

?wait=25 håller förfrågan öppen i upp till 25 sekunder och returnerar så snart jobbet är klart. Undertexter tar oftast några sekunder. AI-transkribering tar ungefär en fjärdedel av videons längd. Om status fortfarande inte är succeeded, failed eller cancelled, anropa den igen.

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. Hämta transkriptet#

result_id är transkriptet. Exportera det som txt, srt, vtt eller json (hela texten, tidsatta segment och ordtider för AI-transkribering). Export är gratis och obegränsad.

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

Nästa steg#

• Att skicka in samma länk igen är gratis: det sparade resultatet returneras.
• Många videor på en gång: batcher, upp till ditt abonnemangs batchstorlek per förfrågan.
• Egna filer: uppladdningar.
• Ingen polling: webhooks anropar dig när ett jobb är klart.
• Från Claude, Cursor eller en annan AI-agent: MCP.