Zum Inhalt springen
Transcript Dock
AnmeldenKostenlos starten

Seitenmenü

Transcript Dock
YouTube-API

YouTube-Transkript-API zuerst Creator-Untertitel, zeitgesteuert pro Cue

Ein Endpunkt für YouTube-Videos und Shorts. Creator-Untertitel kommen zuerst, mit Zeitangabe pro Cue.

1.0Funktionen

Kernvorteile und die Grenzen, die damit einhergehen

Rufen Sie Creator-Untertitel von YouTube-Videos und Shorts als zeitgesteuerte Segmente ab. Für Videos ohne Untertitel gibt es KI-Transkription in den kostenpflichtigen Tarifen.

  1. Zuerst Creator-Untertitel

    Wenn ein Video veröffentlichte Untertitel hat, wird die Creator-Spur direkt gelesen, ohne Audio-Download und ohne Gebühr für KI-Transkription.

  2. Watch-, Teilen- und Shorts-Links

    Standard-Watch-Links, youtu.be-Teilen-Links und Shorts-Links führen alle zum selben Video. Ein Anfrageformat deckt daher alle ab.

  3. Zeitsteuerung für Segmente und Wörter

    Untertitelspuren sind pro Cue zeitgesteuert. Die KI-Transkription liefert die Zeitsteuerung je Wort, sodass Sie Clips schneiden und Zeitleisten synchronisieren können.

  4. Strukturierte Exporte in mehreren Formaten

    Exportieren Sie einheitliche JSON-Ergebnisse oder laden Sie SRT- und WebVTT-Untertiteldateien mit einheitlicher Formatierung herunter.

Betriebliche Grenzen und Transparenz

  • Infrastruktur in einer einzigen Region, bereitgestellt in us-east.
  • Preise: 1 Credit pro Transkript aus Untertiteln und 2 Credits pro begonnener Minute KI-Transkription, abgebucht von einem gemeinsamen Guthaben.
  • Die maximale Medienlänge beträgt 2 Stunden (7,200 Sekunden) pro Quelle.
2.0Umsetzung

Anfrage und Antwort die genaue Anfrage und was zurückkommt

POST/v1/jobs

curl -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer td_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"source": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
},
"mode": "captions_only",
"caption_preference": "prefer_creator"
}'

Ergebnis des Auftrags

{
"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b",
"status": "succeeded",
"stage": null,
"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f",
"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": "Sample YouTube Video",
"upload_id": null
},
"options": {
"mode": "captions_only",
"language": null,
"caption_preference": "prefer_creator"
},
"created_at": "2026-09-12T14:32:00Z"
}
3.0Fragen

Häufige Fragen

Was mit Untertiteln, KI-Transkription und Grenzen für diese Quelle passiert.

Wie geht die API mit Videos ohne Untertitel um?

Wenn der Modus auf auto steht, prüft das System zuerst auf Creator-Untertitel. Gibt es keine, lädt es sicher das Audio und führt eine KI-Transkription aus, die ein Transkript mit Zeitstempeln erzeugt.

Kann ich nur Untertitel anfordern, um KI-Transkriptionsgebühren zu vermeiden?

Ja. Wenn Sie den Modus auf captions_only setzen, läuft garantiert keine KI-Transkription. So bleiben die Extraktionskosten planbar und niedrig.

Werden YouTube-Shorts unterstützt?

Ja. Sowohl Standard-Watch-Links von youtube.com als auch URLs von youtube.com/shorts werden normalisiert und transkribiert.