Você precisa de uma transcrição limpa de um vídeo do YouTube que você possa indexar, resumir, legendar ou alimentar em seu pipeline esta semana. Ao final deste guia, você chamará um endpoint real que retorna linhas de texto com marcação de tempo para um determinado ID de vídeo, e você terá um código que pode copiar e colar em seu aplicativo ou automação.
O que você construirá com a API YouTube Sub Extractor
Zyla API Hub hospeda a API YouTube Sub Extractor, que retorna a transcrição de texto de um vídeo do YouTube como uma sequência de entradas de legendas. Cada entrada inclui o texto mais os metadados de tempo que você pode usar para renderizar legendas, alinhar resumos ou ancorar resultados de busca a um momento no vídeo.
Usos típicos incluem:
- Geração automática de legendas e closed captions com alinhamento de tempo.
- Criação de índices pesquisáveis de conteúdo de vídeo de longa duração.
- Alimentar transcrições para resumidores, pipelines de incorporação ou ferramentas de moderação.
- Construir links de “pular para” em seu aplicativo com base em deslocamentos de transcrição.
Tudo funciona com uma única chave de API e assinatura dentro do Zyla API Hub, que agrega mais de 10.000 APIs públicas em várias categorias. Há uma conta, uma chave de API e um modelo de assinatura + cota—não pagamento por chamada—para que você possa iterar sem precisar gerenciar credenciais separadas por provedor.
Começando no Zyla API Hub
Para experimentar esta API rapidamente:
- Abra a lista de APIs: Iniciar teste de 7 dias na API YouTube Sub Extractor.
- Clique em Assinar ou Iniciar Teste Gratuito quando disponível. Para sua primeira API no Zyla, você geralmente recebe um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais. Não há Plano Gratuito.
- Copie sua chave de API do painel.
- Chame o endpoint mostrado abaixo com Authorization: Bearer YOUR_API_KEY.
Visão geral do endpoint
A API YouTube Sub Extractor atualmente expõe um único endpoint focado para buscar uma transcrição:
- Endpoint: Obter Transcrição de Vídeo
- Método: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- Parâmetro obrigatório: videoId (string)
Envie o videoId do vídeo do YouTube que você deseja transcrever. A API responde com um payload JSON que inclui um sinalizador de sucesso e um array de transcrições de entradas de legendas. Cada entrada contém os campos de texto e tempo que você pode usar em seu aplicativo.
Início rápido: cURL que você pode colar
Abaixo está uma solicitação completa e funcional. Substitua YOUR_API_KEY pela sua chave. O parâmetro videoId é obrigatório, e o exemplo usa um ID específico para demonstrar a forma da resposta.
curl -s -X GET "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript?videoId=eCBABjPcNyo"
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta oficial
Este é o exemplo real de JSON retornado pela API para a solicitação acima. Use-o para estruturar sua lógica de análise.
{"success":true,"transcript":[{"text":"o que a gente tem no diante","duration":3.24,"offset":0,"lang":"en"},{"text":"dos nossos olhos não dá muita esperança","duration":3.24,"offset":3.24,"lang":"en"},{"text":"no futuro daqui eu vejo a polícia","duration":3.24,"offset":6.48,"lang":"en"},{"text":"atirando a dignidade de pais de família","duration":3.24,"offset":9.72,"lang":"en"},{"text":"daqui eu vejo o estado transformando pessoas","duration":3.24,"offset":12.96,"lang":"en"},{"text":"que poderiam dar bons frutos carregado em","duration":3.24,"offset":16.200000000000003,"lang":"en"},{"text":"pessoas frustradas eu não julgo entendeu monstro","duration":3.24,"offset":19.44,"lang":"en"},{"text":"não precisa ser nenhum expert title superlotado","duration":3.24,"offset":22.68,"lang":"en"},{"text":"estudado formada uma coisa pra saber que","duration":3.24,"offset":25.92,"lang":"en"},{"text":"está tudo errado para saber qual a","duration":3.24,"offset":29.160000000000004,"lang":"en"},{"text":"posição da gente isso tem que acabar","duration":3.24,"offset":32.400000000000006,"lang":"en"},{"text":"com os palestinos abete paz [Música] gino","duration":3.24,"offset":35.64,"lang":"en"},{"text":"problema queria só paz mas não viu","duration":3.24,"offset":38.88,"lang":"en"},{"text":"o veículo agora sem proteção da vida","duration":3.24,"offset":42.120000000000005,"lang":"en"},{"text":"e arrojado mas ainda era o então","duration":3.24,"offset":45.36,"lang":"en"},{"text":"ainda disparava e agora o que eu","duration":3.24,"offset":48.6,"lang":"en"},{"text":"faço me fala na maturidade na sala","duration":3.24,"offset":51.84,"lang":"en"},{"text":"tem pesadelo é época de eleição nosso","duration":3.24,"offset":55.080000000000005,"lang":"en"},{"text":"descabelo progresso sem previsão no chão torço","duration":3.24,"offset":58.32000000000001,"lang":"en"},{"text":"pro meu filho também não vira lata","duration":3.24,"offset":61.56,"lang":"en"},{"text":"é um opção tem vaca tem sempre","duration":3.24,"offset":64.80000000000001,"lang":"en"},{"text":"cid piada pode justificar nada eu entrei","duration":3.24,"offset":68.04,"lang":"en"},{"text":"político claro que foi pra vencer nelson","duration":3.24,"offset":71.28,"lang":"en"},{"text":"é um nojo esgoto exposto é alguém","duration":3.24,"offset":74.52000000000001,"lang":"en"},{"text":"é tanta injustiça em sangue nas suas","duration":3.24,"offset":77.76,"lang":"en"},{"text":"mãos por não fazer nada a troca","duration":3.24,"offset":81…
Campos-chave que você usará:
- success: booleano indicando se a solicitação foi bem-sucedida.
- transcript: array de itens de legendas. Cada item inclui:
- text: o texto da legenda para aquele fragmento.
- duration: comprimento numérico do fragmento.
- offset: posição de início numérica a partir do início do vídeo.
- lang: um código de idioma associado ao fragmento.
Exemplo em Python: buscar e unir uma transcrição simples
Este trecho chama o mesmo endpoint e junta as linhas de legendas em uma única string enquanto preserva o tempo para uso posterior. Ele usa o cabeçalho Authorization com sua chave de API e o mesmo videoId que o exemplo cURL para que você possa comparar as saídas.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "eCBABjPcNyo"
URL = "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript"
resp = requests.get(
URL,
params={"videoId": VIDEO_ID},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30
)
resp.raise_for_status()
data = resp.json()
if not data.get("success"):
raise RuntimeError("Solicitação de transcrição não foi bem-sucedida")
entries = data.get("transcript", [])
# Mantenha uma transcrição de texto simples e um índice de âncoras de tempo
full_text = " ".join([e.get("text", "") for e in entries if isinstance(e, dict)])
time_index = [{"offset": e.get("offset"), "duration": e.get("duration"), "text": e.get("text")} for e in entries]
print("Primeiros 200 caracteres da transcrição:")
print(full_text[:200])
print("\nPrimeiras 3 âncoras de tempo:")
for anchor in time_index[:3]:
print(anchor)
Detalhes de implementação que economizam tempo
- Autenticação: passe sua chave via Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Cache: transcrições para um dado videoId são bons candidatos para cache em sua camada para evitar chamadas repetidas em páginas quentes ou trabalhos em lote.
- Paginação: a resposta de exemplo retorna o array completo de transcrições em um único payload. Nenhum parâmetro de paginação é necessário para este endpoint.
- Matemática de tempo: duração e deslocamento são valores numéricos. Preserve-os como estão se você planeja renderizar legendas ou calcular links de salto.
- Idioma: um código de lang é incluído por fragmento. Use-o ao direcionar para tradução ou pipelines de TTS.
- Tratamento de erros: verifique o sinalizador de sucesso antes de usar os dados da transcrição.
Construindo recursos reais em cima da transcrição
Criar SRT ou WebVTT
Converta cada item de transcrição em um bloco de legenda formatando deslocamento e deslocamento+duração em códigos de tempo. Seja qual for a saída SRT ou VTT, mantenha a ordem original das entradas. Como a API já divide a transcrição, você só precisa da lógica de formatação.
Pesquisar com âncoras de tempo
Indexe fragmentos de texto com seus deslocamentos. Quando um usuário pesquisa, mostre linhas correspondentes com um link “Pular para 01:23” com base no deslocamento. Isso reduz a fricção em comparação com a pesquisa em todo o blob de texto.
Resumir ou extrair destaques
Agrupe entradas adjacentes em pedaços de um tamanho alvo (por exemplo, por número de caracteres ou duração total). Alimente esses pedaços em seu resumidor e anexe links ao deslocamento inicial de cada pedaço.
Triagem de segurança de conteúdo
Se você executar verificações de segurança ou conformidade, realize-as primeiro em fragmentos individuais. Isso facilita localizar e redigir trechos problemáticos, já que você já tem deslocamentos e durações.
Chamando a API de um agente de IA (MCP)
Cada API Zyla pode ser invocada a partir de ferramentas de codificação de IA que suportam o Protocolo de Contexto do Modelo. Aponte seu cliente compatível com MCP para este endpoint: MCP.
- Forneça sua chave de API Zyla via a configuração do cliente MCP (o endpoint aceita apikey na URL que você configura para o host da ferramenta).
- De agentes como Claude Code, Cursor ou Windsurf, você pode conectar uma ferramenta que acesse a mesma URL GET usada neste post com o parâmetro videoId.
- O agente recebe o payload JSON e pode pós-processar a transcrição—por exemplo, resumindo, gerando notas ou inserindo referências vinculadas ao tempo em comentários de código.
Se você é novo nas ferramentas MCP da Zyla, comece com uma definição de ferramenta simples que encapsule o único endpoint mostrado aqui e retorne o array de transcrições para o agente para raciocínio adicional.
Notas operacionais sobre o uso do Zyla
- Modelo de acesso: assinatura + cota, não pagamento por chamada. Para sua primeira API no Zyla, você geralmente recebe um teste de 7 dias ou 50 solicitações. Sempre verifique a lista para limites e faturamento atuais.
- Uma chave, muitos serviços: sua chave Zyla funciona em APIs assinadas, o que simplifica a gestão de CI/CD e segredos.
- Fluxos de trabalho em equipe: armazene o cabeçalho Authorization em seu gerenciador de segredos e compartilhe-o via variáveis de ambiente em seu repositório ou plataforma de implantação.
Se você ainda não tem uma conta, pode criar uma em minutos no Zyla API Hub e começar a chamar APIs imediatamente após se inscrever na página de listagem.
Lista de verificação de solução de problemas
- Erros 401/403: confirme se o cabeçalho Authorization está definido como Bearer YOUR_API_KEY, e a chave é válida para sua assinatura.
- Transcrição vazia: verifique novamente a string videoId e certifique-se de que o vídeo tenha dados de legenda disponíveis.
- Códigos de idioma inesperados: registre o campo lang por fragmento e direcione através de sua pilha de tradução, se necessário.
- Timeouts em seu cliente: defina um timeout razoável (por exemplo, 30s) e tente novamente uma vez. Armazene em cache as respostas bem-sucedidas por videoId.
Referência: Endpoint e parâmetros
Obter Transcrição de Vídeo
- Método: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- Parâmetro de consulta obrigatório:
- videoId: a string do ID do vídeo do YouTube (por exemplo, eCBABjPcNyo)
- Autenticação: Authorization: Bearer YOUR_API_KEY
FAQ
O que eu preciso para autenticar solicitações?
Inclua Authorization: Bearer YOUR_API_KEY nos cabeçalhos da solicitação. Você obtém a chave após se inscrever na página de listagem da API.
Quais parâmetros são obrigatórios?
Apenas videoId é obrigatório para o endpoint Obter Transcrição de Vídeo.
A API retorna informações de tempo?
Sim, cada item de transcrição inclui campos numéricos de duração e deslocamento que você pode usar para temporização de legendas e links de salto.
Existe um plano gratuito?
Não há Plano Gratuito. Para sua primeira API no Zyla, você geralmente recebe um teste de 7 dias ou 50 solicitações. Verifique a página da API para acesso e limites atuais.
Posso chamar isso de um agente de IA?
Sim. Use o endpoint MCP e configure sua ferramenta para acessar a mesma URL GET com o parâmetro videoId. Veja o link MCP acima para detalhes.
Pronto para enviar sua integração de transcrição? Inscreva-se na página de listagem e obtenha sua chave agora: Iniciar teste de 7 dias na API YouTube Sub Extractor.