Aller au contenu
Transcript Dock
Se connecterCommencer gratuitement

Menu du site

Transcript Dock
API YouTube

API de transcription YouTube d'abord les sous-titres des créateurs, horodatés bloc par bloc

Un seul endpoint pour les vidéos et les Shorts YouTube. Les sous-titres des créateurs passent en premier, horodatés bloc par bloc.

1.0Fonctionnalités

Principaux avantages et les limites qui les accompagnent

Récupérez les sous-titres des créateurs des vidéos et Shorts YouTube sous forme de segments horodatés, avec la transcription par IA dans les forfaits payants pour les vidéos sans sous-titres.

  1. Sous-titres des créateurs en premier

    Lorsqu'une vidéo a des sous-titres publiés, la piste du créateur est lue directement, sans téléchargement audio ni frais de transcription par IA.

  2. Liens watch, de partage et Shorts

    Les liens watch standards, les liens de partage youtu.be et les liens Shorts renvoient tous à la même vidéo, donc une seule forme de requête suffit.

  3. Horodatage par segment et par mot

    Les pistes de sous-titres sont horodatées bloc par bloc. La transcription par IA renvoie l'horodatage des mots, pour découper des extraits et synchroniser des montages.

  4. Exports structurés en plusieurs formats

    Exportez des résultats JSON unifiés ou téléchargez des fichiers de sous-titres SRT et WebVTT standard, à la mise en forme cohérente.

Limites d'exploitation et transparence

  • Infrastructure à région unique déployée dans us east.
  • Tarifs : 1 crédit par transcription de sous-titres et 2 crédits par minute entamée de transcription par IA, depuis un seul solde.
  • La durée maximale d'un média est de 2 heures (7,200 secondes) par source.
2.0Mise en œuvre

Requête et réponse la requête exacte et ce qui revient

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"
}'

Résultat de la tâche

{
"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.0Aide

Questions fréquentes

Ce qui se passe pour les sous-titres, la transcription par IA et les limites pour cette source.

Comment l'API gère-t-elle les vidéos sans sous-titres fermés ?

Lorsque mode est réglé sur auto, le système vérifie d'abord les sous-titres du créateur. S'il n'en existe aucun, il récupère l'audio en toute sécurité et lance la transcription par IA pour produire une transcription horodatée.

Puis-je demander uniquement les sous-titres pour éviter les frais de transcription par IA ?

Oui. Régler mode sur captions_only garantit qu'aucun pipeline de transcription par IA ne s'exécute, ce qui assure des coûts d'extraction prévisibles et faibles.

Les Shorts YouTube sont-ils pris en charge ?

Oui. Les liens watch standards youtube.com et les URL youtube.com/shorts sont normalisés, puis transcrits.