Felo APIs

YouTube Subtitling API

Rufen Sie YouTube-Untertitel mit optionalen Sprach- und Timestamp-Parametern ab.

GET/v2/youtube/subtitling

Authentifizierung

Bearer API key

Inhaltstyp

Nicht erforderlich

Hinweise zu Limits

Es können endpoint-spezifische Limits gelten.

Web Fetch API

Die YouTube Subtitling API ruft strukturierte Untertiteldaten für ein YouTube-Video ab. Sie richtet sich an Agenten, Werkzeuge zur Inhaltsanalyse, Bildungsprodukte, Suchindizes und Workflows, die Videoinhalte als Text benötigen.

Endpoint

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

Authentifizierung

Senden Sie Ihren API-Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Details zum Erstellen und Verwalten von API-Schlüsseln finden Sie im Authentifizierungsleitfaden.

Verwendung mit KI-Agenten

Installieren Sie das vollständige Paket felo-ai, um einem Agenten YouTube-Untertitel und jeden anderen verfügbaren Felo-Skill bereitzustellen. Der Installer ermittelt dynamisch jedes Paketverzeichnis mit SKILL.md und ist daher nicht von einer festen Skill-Liste abhängig. Installieren Sie alle gefundenen Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills oder Hermes Agent ~/.hermes/skills. Verwenden Sie die manuelle Einrichtungsanleitung für KI-Agenten für die plattformspezifische Konfiguration und Prüfung des API-Schlüssels.

Anfrage

Query-Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
`video_code`	string	Ja	-	YouTube-Video-ID, zum Beispiel `dQw4w9WgXcQ`.
`language`	string	Nein	-	Sprachcode der Untertitel, zum Beispiel `en` oder `zh-CN`. Wenn nicht angegeben, wählt der nachgelagerte Dienst die verfügbare Sprache.
`with_time`	boolean	Nein	`false`	Ob Zeitstempelfelder (`start` und `duration`) für jeden Untertiteleintrag eingeschlossen werden.

Der Dienst verwendet intern den vollständigen Titel-und-Transkript-Modus. Sie müssen keinen Funktions- oder Modusparameter übergeben.

Antwort

Erfolgreiche Antwort

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

Antwortfelder

Feld	Typ	Beschreibung
`status`	string	Antwortstatus. Bei einer erfolgreichen Anfrage normalerweise `ok`.
`message`	string oder null	Zusätzliche Meldung. Bei erfolgreichen Anfragen normalerweise `null`.
`data.title`	string	Titel des YouTube-Videos.
`data.contents`	array	Liste der Untertiteleinträge.
`data.contents[].start`	number	Startzeit des Untertitels in Sekunden. Wird zurückgegeben, wenn Zeitstempeldaten verfügbar sind, insbesondere bei `with_time=true`.
`data.contents[].duration`	number	Dauer des Untertitels in Sekunden. Wird zurückgegeben, wenn Zeitstempeldaten verfügbar sind, insbesondere bei `with_time=true`.
`data.contents[].text`	string	Textinhalt des Untertitels.

Fehlerantworten

HTTP-Status	Fehlercode	Beschreibung	Empfohlene Maßnahme
400	`YOUTUBE_SUBTITLING_FAILED`	Die Anfragevalidierung ist fehlgeschlagen, das Video existiert nicht, Untertitel sind nicht verfügbar oder der nachgelagerte Dienst hat einen clientseitigen Fehler zurückgegeben.	Prüfen Sie `video_code`, die Verfügbarkeit von Untertiteln und `language`.
401	`UNAUTHORIZED`	Der API-Schlüssel fehlt, ist ungültig oder widerrufen.	Prüfen Sie Ihren API-Schlüssel und den Authorization-Header.
500	`YOUTUBE_SUBTITLING_FAILED`	Interner Dienstfehler.	Wiederholen Sie die Anfrage. Kontaktieren Sie den Support, wenn das Problem bleibt.
502	`YOUTUBE_SUBTITLING_FAILED`	Der nachgelagerte YouTube-Untertiteldienst ist fehlgeschlagen oder war nicht verfügbar.	Versuchen Sie es später erneut.

Beispiele

Einfache Anfrage

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

Bestimmte Sprache anfordern

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

Zeitstempel einschließen

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

Zeitstempel für eine bestimmte Sprache einschließen

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"

Anwendungsfälle

Einem Agenten ermöglichen, ein YouTube-Video zu verstehen, bevor er Fragen beantwortet.
Einen durchsuchbaren Textindex für Videoinhalte aufbauen.
Quelltext für Zusammenfassungs- oder Übersetzungs-Workflows vorbereiten.
Generierte Notizen oder Zitate Zeitstempeln zuordnen.
Lehr- oder Forschungsvideos analysieren, ohne die Videodatei herunterzuladen.

Hinweise

Diese API lädt weder Video noch Audio herunter.
Sie gibt vorhandene Untertitel zurück. Für Videos ohne Untertiteldaten werden keine Untertitel generiert.
Einige Videos haben möglicherweise keine Untertitel oder bieten die angeforderte Sprache nicht an.
Wenn language nicht angegeben ist, hängt die Auswahl der Untertitelsprache von der Verfügbarkeit im nachgelagerten Dienst ab.