Início rápido

Três requisições levam um link de vídeo até um arquivo de transcrição. Você precisa de uma chave de API: crie uma na página Chaves de API. Ela é mostrada uma única vez. Toda conta recebe 50 créditos grátis por mês.

1. Enviar um link#

mode: "captions_only" retorna as legendas do vídeo por 1 crédito e funciona em todos os planos, inclusive no teste grátis. Em um plano pago, envie mode: "auto" para usar a transcrição por IA quando um vídeo não tiver legendas (2 créditos por minuto iniciado). A Idempotency-Key é qualquer texto de 8 a 128 caracteres que você escolher. Enviar a mesma chave de novo retorna a mesma tarefa, em vez de criar uma segunda.

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. Aguardar o resultado#

?wait=25 mantém a requisição aberta por até 25 segundos e responde assim que a tarefa terminar. As legendas costumam levar alguns segundos; a transcrição por IA leva cerca de um quarto da duração do vídeo. Se status ainda não for succeeded, failed ou cancelled, faça a chamada de novo.

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. Obter a transcrição#

result_id é a transcrição. Exporte em txt, srt, vtt ou json (texto completo, segmentos com tempo e tempo de cada palavra na transcrição por IA). Exportações são grátis e ilimitadas.

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

Próximos passos#

• Enviar o mesmo link de novo é grátis: o resultado salvo é devolvido.
• Muitos vídeos de uma vez: lotes, até o tamanho do lote do seu plano por requisição.
• Seus próprios arquivos: envios de arquivo.
• Sem consultas repetidas: os webhooks chamam você quando uma tarefa termina.
• A partir do Claude, do Cursor ou de outro agente de IA: MCP.