API de transcrição do YouTube primeiro as legendas do criador, com horário por bloco
Um endpoint para vídeos e Shorts do YouTube. As legendas do criador vêm primeiro, com horário por bloco.
Principais vantagens e os limites que as acompanham
Busque legendas de criadores em vídeos e Shorts do YouTube como segmentos com horário, com transcrição por IA nos planos pagos para vídeos sem legendas.
Limites operacionais e transparência
- Infraestrutura de região única, implantada na região us-east.
- Preço: 1 crédito por transcrição de legendas e 2 créditos por minuto iniciado de transcrição por IA, a partir de um único saldo.
- A duração máxima de mídia é de 2 horas (7,200 segundos) por fonte.
Requisição e resposta a requisição exata e o que volta
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"}'
Resultado da tarefa
{"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"}
Perguntas frequentes
O que acontece com legendas, transcrição por IA e limites para esta fonte.
Como a API lida com vídeos sem legendas fechadas?
Quando o modo está definido como auto, o sistema verifica primeiro as legendas do criador. Se não houver nenhuma, ele obtém o áudio com segurança e roda a transcrição por IA para produzir uma transcrição com horários.
Posso pedir só as legendas para evitar cobranças de transcrição por IA?
Sim. Definir o modo como captions_only garante que nenhum pipeline de transcrição por IA seja executado, o que mantém os custos de extração previsíveis e baixos.
Os YouTube Shorts são compatíveis?
Sim. Tanto os links padrão de watch do youtube.com quanto as URLs youtube.com/shorts são normalizados e transcritos.