Schnellstart

Drei Anfragen bringen einen Videolink zu einer Transkriptdatei. Sie benötigen einen API-Schlüssel. Erstellen Sie ihn auf der Seite API-Schlüssel. Er wird nur einmal angezeigt. Jedes Konto erhält jeden Monat 50 kostenlose Credits.

1. Einen Link senden#

mode: "captions_only" liefert die Untertitel des Videos für 1 Credit und funktioniert in jedem Tarif, auch in der Testphase. In einem bezahlten Tarif senden Sie mode: "auto". Dann greift die API auf die KI-Transkription zurück, wenn ein Video keine Untertitel hat (2 Credits pro begonnener Minute). Der Idempotency-Key ist eine beliebige Zeichenkette mit 8 bis 128 Zeichen, die Sie selbst wählen. Wenn Sie denselben Schlüssel erneut senden, erhalten Sie denselben Auftrag zurück und keinen zweiten.

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. Auf das Ergebnis warten#

?wait=25 hält die Anfrage bis zu 25 Sekunden offen und antwortet, sobald der Auftrag abgeschlossen ist. Untertitel brauchen meist wenige Sekunden. Die KI-Transkription dauert etwa ein Viertel der Videolänge. Wenn status noch nicht succeeded, failed oder cancelled ist, rufen Sie die Anfrage erneut auf.

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. Transkript abrufen#

Die result_id ist das Transkript. Exportieren Sie es als txt, srt, vtt oder json (vollständiger Text, zeitgestempelte Abschnitte, bei KI-Transkription Wortzeiten). Exporte sind kostenlos und unbegrenzt.

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
Willkommen zu diesem Beispiel
 
2
00:00:02,400 --> 00:00:04,900
Dies ist die zweite Zeile

Wie es weitergeht#

• Denselben Link erneut zu senden ist kostenlos: Das gespeicherte Ergebnis wird zurückgegeben.
• Viele Videos auf einmal: Stapel, bis zur Stapelgröße Ihres Tarifs pro Anfrage.
• Eigene Dateien: Dateien hochladen.
• Kein Abfragen nötig: Webhooks benachrichtigen Sie, sobald ein Auftrag abgeschlossen ist.
• Aus Claude, Cursor oder einem anderen KI-Agenten: MCP.