Felo APIs

YouTube Subtitling API

Obtenha legendas do YouTube com parâmetros opcionais de idioma e timestamp.

GET/v2/youtube/subtitling

Autenticação

Bearer API key

Tipo de conteúdo

Não obrigatório

Notas de limite

Podem se aplicar limites específicos do endpoint.

Web Fetch API

A YouTube Subtitling API obtém dados estruturados de legendas de um vídeo do YouTube. Ela é projetada para agentes, ferramentas de análise de conteúdo, produtos educacionais, índices de busca e fluxos de trabalho que precisam do conteúdo de vídeos em texto.

Endpoint

GET https://openapi.felo.ai/v2/youtube/subtitling

Autenticação

Envie sua chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Consulte o guia de autenticação para detalhes sobre como criar e gerenciar chaves de API.

Uso com agentes de IA

Instale o pacote completo felo-ai para dar a um agente a legendagem do YouTube e todos os demais Felo Skills disponíveis. O instalador descobre dinamicamente todos os diretórios de pacote que contêm SKILL.md, então não depende de uma lista fixa de Skills. Instale todos os Skills descobertos em ~/.codex/skills para o Codex, ~/.claude/skills para o Claude Code, ~/.agents/skills para o OpenClaw ou ~/.hermes/skills para o Hermes Agent. Use o guia de configuração manual de agentes de IA para ver a configuração da chave de API e a verificação de cada plataforma.

Requisição

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`video_code`	string	Sim	-	ID do vídeo do YouTube, como `dQw4w9WgXcQ`.
`language`	string	Não	-	Código de idioma das legendas, como `en` ou `zh-CN`. Se omitido, o serviço downstream escolhe o idioma disponível.
`with_time`	boolean	Não	`false`	Se deve incluir os campos de timestamp (`start` e `duration`) de cada item de legenda.

O serviço usa internamente o modo completo de título e transcrição. Você não precisa passar um tipo de função nem um parâmetro de modo.

Resposta

Resposta de sucesso

{
  "status": "ok",
  "message": null,
  "data": {
    "title": "Example Video Title",
    "contents": [
      {
        "start": 0.32,
        "duration": 14.26,
        "text": "Subtitle text"
      }
    ]
  }
}

Campos da resposta

Campo	Tipo	Descrição
`status`	string	Status da resposta. Normalmente `ok` para uma requisição bem-sucedida.
`message`	string ou null	Mensagem adicional. Normalmente `null` para requisições bem-sucedidas.
`data.title`	string	Título do vídeo do YouTube.
`data.contents`	array	Lista de itens de legenda.
`data.contents[].start`	number	Horário de início da legenda em segundos. Retornado quando dados de timestamp estão disponíveis, especialmente com `with_time=true`.
`data.contents[].duration`	number	Duração da legenda em segundos. Retornada quando dados de timestamp estão disponíveis, especialmente com `with_time=true`.
`data.contents[].text`	string	Conteúdo de texto da legenda.

Respostas de erro

Status HTTP	Código de erro	Descrição	Ação sugerida
400	`YOUTUBE_SUBTITLING_FAILED`	A validação da requisição falhou, o vídeo não existe, as legendas não estão disponíveis ou o serviço downstream retornou um erro do lado do cliente.	Verifique `video_code`, a disponibilidade das legendas e `language`.
401	`UNAUTHORIZED`	A chave de API está faltando, é inválida ou foi revogada.	Verifique sua chave de API e o cabeçalho de autorização.
500	`YOUTUBE_SUBTITLING_FAILED`	Erro interno do serviço.	Tente novamente. Fale com o suporte se o problema persistir.
502	`YOUTUBE_SUBTITLING_FAILED`	O serviço downstream de legendas do YouTube falhou ou estava indisponível.	Tente novamente mais tarde.

Exemplos

Requisição básica

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Solicitar um idioma específico

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

Incluir timestamps

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Incluir timestamps para um idioma específico

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=zh-CN&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Casos de uso

Permitir que um agente entenda um vídeo do YouTube antes de responder a perguntas.
Criar um índice de texto pesquisável para o conteúdo de vídeos.
Preparar o texto de origem para fluxos de resumo ou tradução.
Mapear notas ou citações geradas de volta para timestamps.
Analisar vídeos educacionais ou de pesquisa sem baixar o arquivo de vídeo.

Observações

Esta API não baixa vídeo nem áudio.
Ela retorna as legendas existentes. Não gera legendas para vídeos que não têm dados de legenda.
Alguns vídeos podem não ter legendas ou não oferecer o idioma solicitado.
Se language for omitido, a escolha do idioma das legendas depende da disponibilidade downstream.