Felo APIs

YouTube Subtitling API

Отримуйте субтитри YouTube з необов’язковими параметрами мови й часових позначок.

GET/v2/youtube/subtitling

Автентифікація

Bearer API key

Тип вмісту

Не потрібно

Примітки щодо обмежень

Можуть діяти обмеження для окремих endpoint.

Web Fetch API

YouTube Subtitling API отримує структуровані дані субтитрів для відео на YouTube. Він призначений для агентів, інструментів аналізу вмісту, освітніх продуктів, пошукових індексів і робочих процесів, яким потрібен відеовміст у текстовому вигляді.

Endpoint

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

Автентифікація

Надішліть свій API-ключ у заголовку Authorization:

Authorization: Bearer YOUR_API_KEY

Про створення та керування API-ключами див. посібник з автентифікації.

Використання з агентами ШІ

Установіть повний пакет felo-ai, щоб надати агенту субтитри YouTube та всі інші доступні Felo Skills. Інсталятор динамічно знаходить кожен каталог пакета, що містить SKILL.md, тому не залежить від фіксованого списку Skills. Установіть усі знайдені Skills у Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills або Hermes Agent ~/.hermes/skills. Використовуйте посібник з ручного налаштування агента ШІ, щоб дізнатися про налаштування API-ключа та перевірку для кожної платформи.

Запит

Параметри запиту

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
`video_code`	string	Так	-	ID відео YouTube, наприклад `dQw4w9WgXcQ`.
`language`	string	Ні	-	Код мови субтитрів, наприклад `en` або `zh-CN`. Якщо не вказано, сервіс нижчого рівня вибирає доступну мову.
`with_time`	boolean	Ні	`false`	Чи включати поля часових позначок (`start` і `duration`) для кожного елемента субтитрів.

Сервіс внутрішньо використовує повний режим заголовка та транскрипту. Вам не потрібно передавати тип функції або параметр режиму.

Відповідь

Успішна відповідь

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

Поля відповіді

Поле	Тип	Опис
`status`	string	Статус відповіді. Зазвичай `ok` для успішного запиту.
`message`	string or null	Додаткове повідомлення. Зазвичай `null` для успішних запитів.
`data.title`	string	Заголовок відео YouTube.
`data.contents`	array	Список елементів субтитрів.
`data.contents[].start`	number	Час початку субтитрів у секундах. Повертається, коли доступні дані часових позначок, особливо якщо `with_time=true`.
`data.contents[].duration`	number	Тривалість субтитрів у секундах. Повертається, коли доступні дані часових позначок, особливо якщо `with_time=true`.
`data.contents[].text`	string	Текстовий вміст субтитрів.

Відповіді з помилками

Статус HTTP	Код помилки	Опис	Рекомендована дія
400	`YOUTUBE_SUBTITLING_FAILED`	Не вдалося перевірити запит, відео не існує, субтитри недоступні або сервіс нижчого рівня повернув помилку на боці клієнта.	Перевірте `video_code`, доступність субтитрів і `language`.
401	`UNAUTHORIZED`	API-ключ відсутній, недійсний або відкликаний.	Перевірте свій API-ключ і заголовок авторизації.
500	`YOUTUBE_SUBTITLING_FAILED`	Внутрішня помилка сервісу.	Повторіть запит. Якщо проблема не зникає, зверніться до підтримки.
502	`YOUTUBE_SUBTITLING_FAILED`	Сервіс субтитрів YouTube нижчого рівня не працював або був недоступний.	Повторіть спробу пізніше.

Приклади

Базовий запит

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

Запит певної мови

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

Включення часових позначок

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

Включення часових позначок для певної мови

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"

Варіанти використання

Дозвольте агенту зрозуміти відео на YouTube перед відповіддю на запитання.
Побудуйте текстовий індекс для пошуку за відеовмістом.
Підготуйте вихідний текст для робочих процесів підсумовування або перекладу.
Зіставте згенеровані нотатки або цитати з часовими позначками.
Аналізуйте освітні або дослідницькі відео без завантаження відеофайлу.

Примітки

Цей API не завантажує відео чи аудіо.
Він повертає наявні субтитри. Він не генерує субтитри для відео, які не мають даних субтитрів.
Деякі відео можуть не мати субтитрів або не надавати запитану мову.
Якщо language не вказано, вибір мови субтитрів залежить від доступності на нижчому рівні.