Felo APIs

YouTube Subtitling API

Pobieraj napisy YouTube z opcjonalnymi parametrami języka i znaczników czasu.

GET/v2/youtube/subtitling

Uwierzytelnianie

Bearer API key

Typ zawartości

Nie jest wymagane

Uwagi o limitach

Mogą obowiązywać limity dla poszczególnych endpointów.

Web Fetch API

API napisów YouTube pobiera uporządkowane dane napisów dla filmu z YouTube. Jest przeznaczone dla agentów, narzędzi do analizy treści, produktów edukacyjnych, indeksów wyszukiwania i przepływów pracy, które potrzebują treści wideo w formie tekstu.

Endpoint

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

Uwierzytelnianie

Wyślij klucz API w nagłówku Authorization:

Authorization: Bearer YOUR_API_KEY

Szczegóły tworzenia kluczy API i zarządzania nimi znajdziesz w przewodniku uwierzytelniania.

Użycie z agentami AI

Zainstaluj kompletny pakiet felo-ai, aby dać agentowi napisy YouTube i każdy inny dostępny Felo Skill. Instalator dynamicznie wykrywa każdy katalog pakietu zawierający SKILL.md, więc nie zależy od stałej listy Skills. Zainstaluj wszystkie wykryte Skills w Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills lub Hermes Agent ~/.hermes/skills. Użyj podręcznika konfiguracji agenta AI, aby poznać konfigurację klucza API i weryfikację dla poszczególnych platform.

Żądanie

Parametry zapytania

Parametr	Typ	Wymagany	Domyślnie	Opis
`video_code`	string	Tak	-	Identyfikator filmu YouTube, na przykład `dQw4w9WgXcQ`.
`language`	string	Nie	-	Kod języka napisów, na przykład `en` lub `zh-CN`. Jeśli go pominiesz, usługa podrzędna wybierze dostępny język.
`with_time`	boolean	Nie	`false`	Czy dołączać pola znaczników czasu (`start` i `duration`) do każdej pozycji napisów.

Usługa wewnętrznie używa trybu pełnego tytułu i transkrypcji. Nie musisz przekazywać parametru typu funkcji ani trybu.

Odpowiedź

Odpowiedź sukcesu

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

Pola odpowiedzi

Pole	Typ	Opis
`status`	string	Stan odpowiedzi. Zwykle `ok` dla skutecznego żądania.
`message`	string or null	Dodatkowy komunikat. Zwykle `null` dla skutecznych żądań.
`data.title`	string	Tytuł filmu YouTube.
`data.contents`	array	Lista pozycji napisów.
`data.contents[].start`	number	Czas rozpoczęcia napisów w sekundach. Zwracany, gdy dane znaczników czasu są dostępne, zwłaszcza gdy `with_time=true`.
`data.contents[].duration`	number	Czas trwania napisów w sekundach. Zwracany, gdy dane znaczników czasu są dostępne, zwłaszcza gdy `with_time=true`.
`data.contents[].text`	string	Treść tekstowa napisów.

Odpowiedzi błędów

Status HTTP	Kod błędu	Opis	Sugerowane działanie
400	`YOUTUBE_SUBTITLING_FAILED`	Walidacja żądania nie powiodła się, film nie istnieje, napisy są niedostępne lub usługa podrzędna zwróciła błąd po stronie klienta.	Sprawdź `video_code`, dostępność napisów i `language`.
401	`UNAUTHORIZED`	Klucz API jest brakujący, nieprawidłowy lub unieważniony.	Zweryfikuj klucz API i nagłówek autoryzacji.
500	`YOUTUBE_SUBTITLING_FAILED`	Wewnętrzny błąd usługi.	Ponów żądanie. Skontaktuj się z pomocą techniczną, jeśli problem się utrzymuje.
502	`YOUTUBE_SUBTITLING_FAILED`	Podrzędna usługa napisów YouTube zawiodła lub była niedostępna.	Ponów później.

Przykłady

Podstawowe żądanie

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

Żądanie określonego języka

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

Dołączanie znaczników czasu

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

Dołączanie znaczników czasu dla określonego języka

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"

Zastosowania

Pozwól agentowi zrozumieć film z YouTube przed udzieleniem odpowiedzi na pytania.
Zbuduj przeszukiwalny indeks tekstowy treści wideo.
Przygotuj tekst źródłowy do przepływów podsumowywania lub tłumaczenia.
Przypisz wygenerowane notatki lub cytaty do znaczników czasu.
Analizuj filmy edukacyjne lub badawcze bez pobierania pliku wideo.

Uwagi

To API nie pobiera wideo ani audio.
Zwraca istniejące napisy. Nie generuje napisów dla filmów, które nie mają danych napisów.
Niektóre filmy mogą nie mieć napisów lub nie udostępniać żądanego języka.
Jeśli language zostanie pominięty, wybór języka napisów zależy od dostępności w usłudze podrzędnej.