Felo APIs

YouTube Subtitling API

Obtén subtítulos de YouTube con parámetros opcionales de idioma y marca de tiempo.

GET/v2/youtube/subtitling

Autenticación

Bearer API key

Tipo de contenido

No requiere

Notas sobre límites

Pueden aplicarse límites específicos del endpoint.

Web Fetch API

La YouTube Subtitling API obtiene datos estructurados de subtítulos de un video de YouTube. Está diseñada para agentes, herramientas de análisis de contenido, productos educativos, índices de búsqueda y flujos de trabajo que necesitan el contenido del video como texto.

Endpoint

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

Autenticación

Envía tu clave de API en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Consulta la guía de autenticación para obtener detalles sobre la creación y gestión de claves de API.

Uso con agentes de IA

Instala el paquete completo felo-ai para dar a un agente los subtítulos de YouTube y todas las demás Felo Skills disponibles. El instalador descubre dinámicamente todos los directorios del paquete que contengan SKILL.md, por lo que no depende de una lista fija de Skills. Instala todas las Skills descubiertas en Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Usa la guía de configuración manual de agentes de IA para la configuración y verificación de la clave de API específicas de cada plataforma.

Solicitud

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
`video_code`	string	Sí	-	ID del video de YouTube, por ejemplo `dQw4w9WgXcQ`.
`language`	string	No	-	Código de idioma de los subtítulos, por ejemplo `en` o `zh-CN`. Si se omite, el servicio downstream elige el idioma disponible.
`with_time`	boolean	No	`false`	Indica si se incluyen los campos de marca de tiempo (`start` y `duration`) en cada elemento de subtítulo.

El servicio usa internamente el modo completo de título y transcripción. No necesitas pasar ningún parámetro de tipo de función ni de modo.

Respuesta

Respuesta correcta

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

Campos de la respuesta

Campo	Tipo	Descripción
`status`	string	Estado de la respuesta. Normalmente `ok` en una solicitud correcta.
`message`	string o null	Mensaje adicional. Normalmente `null` en las solicitudes correctas.
`data.title`	string	Título del video de YouTube.
`data.contents`	array	Lista de elementos de subtítulo.
`data.contents[].start`	number	Hora de inicio del subtítulo en segundos. Se devuelve cuando hay datos de marca de tiempo disponibles, especialmente con `with_time=true`.
`data.contents[].duration`	number	Duración del subtítulo en segundos. Se devuelve cuando hay datos de marca de tiempo disponibles, especialmente con `with_time=true`.
`data.contents[].text`	string	Contenido de texto del subtítulo.

Respuestas de error

Estado HTTP	Código de error	Descripción	Acción sugerida
400	`YOUTUBE_SUBTITLING_FAILED`	Falló la validación de la solicitud, el video no existe, los subtítulos no están disponibles o el servicio downstream devolvió un error del lado del cliente.	Comprueba `video_code`, la disponibilidad de subtítulos y `language`.
401	`UNAUTHORIZED`	Falta la clave de API, no es válida o está revocada.	Verifica tu clave de API y el encabezado de autorización.
500	`YOUTUBE_SUBTITLING_FAILED`	Error interno del servicio.	Reintenta la solicitud. Contacta con soporte si el problema persiste.
502	`YOUTUBE_SUBTITLING_FAILED`	El servicio downstream de subtítulos de YouTube falló o no estaba disponible.	Vuelve a intentarlo más tarde.

Ejemplos

Solicitud básica

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

Solicitar un idioma concreto

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

Incluir marcas de tiempo

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

Incluir marcas de tiempo para un idioma concreto

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 un agente entienda un video de YouTube antes de responder preguntas.
Crear un índice de texto consultable para contenido de video.
Preparar el texto de origen para flujos de trabajo de resumen o traducción.
Asociar notas o citas generadas con sus marcas de tiempo.
Analizar videos educativos o de investigación sin descargar el archivo de video.

Notas

Esta API no descarga video ni audio.
Devuelve los subtítulos existentes. No genera subtítulos para videos que no tienen datos de subtítulos.
Algunos videos pueden no tener subtítulos o no ofrecer el idioma solicitado.
Si se omite language, la selección del idioma de los subtítulos depende de la disponibilidad downstream.