Настройка Harness
YouTube Subtitling API
Получайте YouTube subtitles с optional language и timestamp parameters.
GET
/v2/youtube/subtitlingАутентификация
Bearer API key
Content type
Не требуется
Ограничения
Могут применяться ограничения конкретного endpoint.
YouTube Subtitling API получает structured subtitle data для YouTube video, чтобы Agent, content analysis tools, education products, search indexes и summary/translation workflows могли работать с video text.
Endpoint
GET https://openapi.felo.ai/v2/youtube/subtitlingАутентификация
Authorization: Bearer YOUR_API_KEYQuery Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
video_code | string | Да | - | YouTube video ID, например dQw4w9WgXcQ |
language | string | Нет | - | код языка субтитров, например en or zh-CN; если опущено, downstream service выберет доступный язык |
with_time | boolean | Нет | false | Возвращать ли start and duration для каждого subtitle item |
Ответ Fields
| Поле | Тип | Описание |
|---|---|---|
data.title | string | Название YouTube video |
data.contents | array | Subtitle items |
data.contents[].start | number | Время начала субтитра в секундах |
data.contents[].duration | number | Длительность субтитра в секундах |
data.contents[].text | string | Subtitle text |
Example
curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en&with_time=true" \
-H "Authorization: Bearer YOUR_API_KEY"Сценарии использования
- Let an Agent understand a YouTube video before answering questions.
- Создает поисковый текстовый index для video content.
- Готовит исходный текст для summarization или translation workflows.
- Map notes, quotes, or summaries back to timestamps.
Примечания
- This API does not download video or audio, and only returns existing subtitles.
- Some videos may not have subtitles or the requested language.
- If
languageis omitted, subtitle selection depends on downstream availability.
Error Responses
| HTTP Status | Error Code | Описание | Рекомендуемое действие |
|---|---|---|---|
| 400 | YOUTUBE_SUBTITLING_FAILED | validation failed, video does not exist, subtitles unavailable, or downstream client-side error | Check video_code, subtitle availability, and language |
| 401 | INVALID_API_KEY | API key missing, invalid, or revoked | Verify API key and authorization header |
| 500 | YOUTUBE_SUBTITLING_FAILED | Внутренняя ошибка сервиса | Retry; contact support if it persists |
| 502 | YOUTUBE_SUBTITLING_FAILED | Downstream subtitle service failed or unavailable | Повторите позже |