Démarrage rapide

Trois requêtes transforment un lien vidéo en fichier de transcription. Il vous faut une clé API : créez-la sur la page Clés API. Elle n'est affichée qu'une seule fois. Chaque compte reçoit 50 crédits gratuits par mois.

1. Envoyer un lien#

mode: "captions_only" renvoie les sous-titres de la vidéo pour 1 crédit et fonctionne sur tous les forfaits, y compris l'essai gratuit. Sur un forfait payant, envoyez mode: "auto" pour passer à la transcription par IA lorsqu'une vidéo n'a pas de sous-titres (2 crédits par minute commencée). La Idempotency-Key est une chaîne de 8 à 128 caractères de votre choix. Renvoyer la même clé donne la même tâche au lieu d'en créer une seconde.

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. Attendre le résultat#

?wait=25 maintient la requête ouverte jusqu'à 25 secondes et répond dès que la tâche se termine. Les sous-titres arrivent généralement en quelques secondes. La transcription par IA prend environ un quart de la durée de la vidéo. Si status n'est pas encore succeeded, failed ou cancelled, relancez l'appel.

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. Récupérer la transcription#

result_id est la transcription. Exportez-la au format txt, srt, vtt ou json (texte complet, segments horodatés, horodatages par mot pour la transcription par IA). Les exports sont gratuits et illimités.

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
Welcome to this video.
 
2
00:00:02,400 --> 00:00:04,900
Today we cover the basics.

Et ensuite#

• Renvoyer le même lien est gratuit : le résultat enregistré est renvoyé.
• Plusieurs vidéos à la fois : lots, jusqu'à la taille de lot de votre forfait par requête.
• Vos propres fichiers : envoi de fichiers.
• Sans interrogation : les webhooks vous appellent lorsqu'une tâche se termine.
• Depuis Claude, Cursor ou un autre agent IA : MCP.