Felo APIs

YouTube Subtitling API

Získávejte titulky YouTube s volitelnými parametry jazyka a časových značek.

GET/v2/youtube/subtitling

Ověřování

Bearer API key

Typ obsahu

Není vyžadováno

Poznámky k limitům

Mohou platit limity pro jednotlivé endpointy.

Web Fetch API

YouTube Subtitling API načítá strukturovaná data titulků pro video na YouTube. Je navrženo pro agenty, nástroje pro analýzu obsahu, vzdělávací produkty, vyhledávací indexy a workflow, které potřebují obsah videa jako text.

Endpoint

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

Ověřování

Odešlete svůj API klíč v hlavičce Authorization:

Authorization: Bearer YOUR_API_KEY

Podrobnosti o vytváření a správě API klíčů najdete v příručce k ověřování.

Použití s AI agenty

Nainstalujte kompletní balíček felo-ai, aby agent mohl získávat titulky z YouTube a používat všechny ostatní dostupné Felo Skills. Instalátor dynamicky objevuje každý adresář balíčku obsahující SKILL.md, takže nezávisí na pevném seznamu Skills. Nainstalujte všechny objevené Skills do ~/.codex/skills pro Codex, ~/.claude/skills pro Claude Code, ~/.agents/skills pro OpenClaw nebo ~/.hermes/skills pro Hermes Agent. Konfiguraci API klíče specifickou pro platformu a ověření najdete v příručce k ručnímu nastavení AI agenta.

Požadavek

Parametry dotazu

Parametr	Typ	Povinné	Výchozí	Popis
`video_code`	string	Ano	-	ID videa na YouTube, například `dQw4w9WgXcQ`.
`language`	string	Ne	-	Kód jazyka titulků, například `en` nebo `zh-CN`. Pokud je vynechán, navazující služba zvolí dostupný jazyk.
`with_time`	boolean	Ne	`false`	Zda má být u každé položky titulků uvedeno pole časových značek (`start` a `duration`).

Služba interně používá režim celého názvu a přepisu. Nemusíte předávat parametr typu funkce ani režimu.

Odpověď

Úspěšná odpověď

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

Pole odpovědi

Pole	Typ	Popis
`status`	string	Stav odpovědi. U úspěšného požadavku obvykle `ok`.
`message`	string nebo null	Doplňující zpráva. U úspěšných požadavků obvykle `null`.
`data.title`	string	Název videa na YouTube.
`data.contents`	array	Seznam položek titulků.
`data.contents[].start`	number	Čas začátku titulku v sekundách. Vrací se, když jsou dostupná data časových značek, zejména když je `with_time=true`.
`data.contents[].duration`	number	Doba trvání titulku v sekundách. Vrací se, když jsou dostupná data časových značek, zejména když je `with_time=true`.
`data.contents[].text`	string	Obsah textu titulku.

Chybové odpovědi

Stav HTTP	Kód chyby	Popis	Doporučená akce
400	`YOUTUBE_SUBTITLING_FAILED`	Ověření požadavku selhalo, video neexistuje, titulky nejsou dostupné nebo navazující služba vrátila chybu na straně klienta.	Zkontrolujte `video_code`, dostupnost titulků a `language`.
401	`UNAUTHORIZED`	API klíč chybí, je neplatný nebo zrušený.	Ověřte svůj API klíč a hlavičku autorizace.
500	`YOUTUBE_SUBTITLING_FAILED`	Interní chyba služby.	Zopakujte požadavek. Pokud problém přetrvává, kontaktujte podporu.
502	`YOUTUBE_SUBTITLING_FAILED`	Navazující služba titulků YouTube selhala nebo byla nedostupná.	Zopakujte později.

Příklady

Základní požadavek

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

Požadavek na konkrétní jazyk

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

Zahrnutí časových značek

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

Zahrnutí časových značek pro konkrétní jazyk

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"

Případy použití

Nechte agenta porozumět videu na YouTube dříve, než odpoví na otázky.
Vytvořte prohledávatelný textový index obsahu videa.
Připravte zdrojový text pro workflow shrnutí nebo překladu.
Namapujte vygenerované poznámky nebo citace zpět na časové značky.
Analyzujte vzdělávací nebo výzkumná videa bez stahování videosouboru.

Poznámky

Toto API nestahuje video ani zvuk.
Vrací existující titulky. Negeneruje titulky pro videa, která nemají data titulků.
Některá videa nemusí mít titulky nebo nemusí nabízet požadovaný jazyk.
Pokud je language vynechán, volba jazyka titulků závisí na dostupnosti v navazující službě.