Felo APIs

YouTube Subtitling API

Recupera i sottotitoli di YouTube con parametri opzionali di lingua e timestamp.

GET/v2/youtube/subtitling

Autenticazione

Bearer API key

Tipo di contenuto

Non richiesto

Note sui limiti

Possono applicarsi limiti specifici dell'endpoint.

Web Fetch API

La YouTube Subtitling API recupera dati strutturati dei sottotitoli di un video YouTube. È pensata per agenti, strumenti di analisi dei contenuti, prodotti per la formazione, indici di ricerca e workflow che hanno bisogno del contenuto video come testo.

Endpoint

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

Autenticazione

Invia la tua chiave API nell'header Authorization:

Authorization: Bearer YOUR_API_KEY

Vedi la guida all'autenticazione per i dettagli sulla creazione e gestione delle chiavi API.

Uso con agenti IA

Installa il pacchetto completo felo-ai per dare a un agente i sottotitoli YouTube e ogni altra Felo Skill disponibile. L'installer individua dinamicamente ogni directory del pacchetto che contiene SKILL.md, quindi non dipende da un elenco fisso di Skill. Installa tutte le Skill trovate in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Usa la guida alla configurazione manuale degli agenti IA per la configurazione della chiave API e la verifica su ogni piattaforma.

Richiesta

Parametri di query

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
`video_code`	string	Sì	-	ID del video YouTube, come `dQw4w9WgXcQ`.
`language`	string	No	-	Codice lingua dei sottotitoli, come `en` o `zh-CN`. Se omesso, il servizio a valle sceglie la lingua disponibile.
`with_time`	boolean	No	`false`	Se includere i campi di timestamp (`start` e `duration`) per ogni voce dei sottotitoli.

Il servizio usa internamente la modalità completa titolo e trascrizione. Non devi passare un tipo di funzione o un parametro di modalità.

Risposta

Risposta di successo

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

Campi della risposta

Campo	Tipo	Descrizione
`status`	string	Stato della risposta. Di solito `ok` per una richiesta riuscita.
`message`	string o null	Messaggio aggiuntivo. Di solito `null` per le richieste riuscite.
`data.title`	string	Titolo del video YouTube.
`data.contents`	array	Elenco delle voci dei sottotitoli.
`data.contents[].start`	number	Ora di inizio del sottotitolo in secondi. Restituito quando i dati di timestamp sono disponibili, in particolare con `with_time=true`.
`data.contents[].duration`	number	Durata del sottotitolo in secondi. Restituita quando i dati di timestamp sono disponibili, in particolare con `with_time=true`.
`data.contents[].text`	string	Contenuto testuale del sottotitolo.

Risposte di errore

Stato HTTP	Codice di errore	Descrizione	Azione consigliata
400	`YOUTUBE_SUBTITLING_FAILED`	Convalida della richiesta non riuscita, il video non esiste, i sottotitoli non sono disponibili oppure il servizio a valle ha restituito un errore lato client.	Controlla `video_code`, la disponibilità dei sottotitoli e `language`.
401	`UNAUTHORIZED`	La chiave API manca, non è valida o è revocata.	Verifica la chiave API e l'header di autorizzazione.
500	`YOUTUBE_SUBTITLING_FAILED`	Errore interno del servizio.	Riprova la richiesta. Contatta il supporto se il problema persiste.
502	`YOUTUBE_SUBTITLING_FAILED`	Il servizio di sottotitoli YouTube a valle non ha funzionato o non era disponibile.	Riprova più tardi.

Esempi

Richiesta di base

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

Richiedere una lingua specifica

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

Includere i timestamp

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

Includere i timestamp per una lingua specifica

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"

Casi d'uso

Permettere a un agente di capire un video YouTube prima di rispondere alle domande.
Creare un indice testuale ricercabile per i contenuti video.
Preparare il testo di partenza per workflow di riepilogo o traduzione.
Collegare appunti o citazioni generati ai timestamp.
Analizzare video didattici o di ricerca senza scaricare il file video.

Note

Questa API non scarica video o audio.
Restituisce i sottotitoli esistenti. Non genera sottotitoli per video che non hanno dati di sottotitoli.
Alcuni video potrebbero non avere sottotitoli oppure non fornire la lingua richiesta.
Se language viene omesso, la scelta della lingua dei sottotitoli dipende dalla disponibilità a valle.