Felo APIs

YouTube Subtitling API

Récupérez les sous-titres YouTube avec des paramètres optionnels de langue et d'horodatage.

GET/v2/youtube/subtitling

Authentification

Bearer API key

Type de contenu

Non requis

Notes sur les limites

Des limites propres à l'endpoint peuvent s'appliquer.

Web Fetch API

L'API YouTube Subtitling récupère des données de sous-titres structurées pour une vidéo YouTube. Elle est conçue pour les agents, les outils d'analyse de contenu, les produits éducatifs, les index de recherche et les workflows qui ont besoin du contenu vidéo sous forme de texte.

Endpoint

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

Authentification

Envoyez votre clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Consultez le guide d'authentification pour les détails sur la création et la gestion des clés API.

Utilisation avec des agents IA

Installez le paquet complet felo-ai pour fournir à un agent le sous-titrage YouTube et tous les autres Felo Skills disponibles. L'installateur découvre dynamiquement chaque répertoire de paquet contenant SKILL.md, il ne dépend donc pas d'une liste figée de Skills. Installez tous les Skills découverts dans Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills ou Hermes Agent ~/.hermes/skills. Utilisez le guide d'installation manuelle des agents IA pour la configuration des clés API et la vérification propres à chaque plateforme.

Requête

Paramètres de requête

Paramètre	Type	Requis	Par défaut	Description
`video_code`	string	Oui	-	ID de vidéo YouTube, par exemple `dQw4w9WgXcQ`.
`language`	string	Non	-	Code de langue des sous-titres, par exemple `en` ou `zh-CN`. S'il est omis, le service en aval choisit la langue disponible.
`with_time`	boolean	Non	`false`	Indique s'il faut inclure les champs d'horodatage (`start` et `duration`) pour chaque élément de sous-titre.

Le service utilise en interne le mode titre et transcription complet. Vous n'avez pas besoin de passer de paramètre de type de fonction ou de mode.

Réponse

Réponse de succès

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

Champs de réponse

Champ	Type	Description
`status`	string	Statut de la réponse. Généralement `ok` pour une requête réussie.
`message`	string or null	Message supplémentaire. Généralement `null` pour les requêtes réussies.
`data.title`	string	Titre de la vidéo YouTube.
`data.contents`	array	Liste des éléments de sous-titres.
`data.contents[].start`	number	Heure de début du sous-titre en secondes. Renvoyée lorsque des données d'horodatage sont disponibles, notamment lorsque `with_time=true`.
`data.contents[].duration`	number	Durée du sous-titre en secondes. Renvoyée lorsque des données d'horodatage sont disponibles, notamment lorsque `with_time=true`.
`data.contents[].text`	string	Contenu textuel du sous-titre.

Réponses d'erreur

Statut HTTP	Code d'erreur	Description	Action suggérée
400	`YOUTUBE_SUBTITLING_FAILED`	La validation de la requête a échoué, la vidéo n'existe pas, les sous-titres sont indisponibles ou le service en aval a renvoyé une erreur côté client.	Vérifiez `video_code`, la disponibilité des sous-titres et `language`.
401	`UNAUTHORIZED`	La clé API est manquante, invalide ou révoquée.	Vérifiez votre clé API et l'en-tête d'autorisation.
500	`YOUTUBE_SUBTITLING_FAILED`	Erreur interne du service.	Réessayez la requête. Contactez le support si le problème persiste.
502	`YOUTUBE_SUBTITLING_FAILED`	Le service de sous-titres YouTube en aval a échoué ou était indisponible.	Réessayez plus tard.

Exemples

Requête de base

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

Demander une langue spécifique

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

Inclure les horodatages

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

Inclure les horodatages pour une langue spécifique

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"

Cas d'usage

Permettre à un agent de comprendre une vidéo YouTube avant de répondre à des questions.
Construire un index textuel interrogeable pour le contenu vidéo.
Préparer du texte source pour des workflows de résumé ou de traduction.
Rattacher des notes ou citations générées aux horodatages.
Analyser des vidéos éducatives ou de recherche sans télécharger le fichier vidéo.

Remarques

Cette API ne télécharge ni vidéo ni audio.
Elle renvoie les sous-titres existants. Elle ne génère pas de sous-titres pour les vidéos qui n'ont pas de données de sous-titres.
Certaines vidéos peuvent ne pas avoir de sous-titres, ou ne pas proposer la langue demandée.
Si language est omis, le choix de la langue des sous-titres dépend de la disponibilité en aval.