Harness 설정
YouTube Subtitling API
선택 언어와 timestamp parameter로 YouTube subtitles를 가져오세요.
GET
/v2/youtube/subtitling인증
Bearer API key
Content type
필요 없음
속도 제한
endpoint별 제한이 적용될 수 있습니다.
YouTube Subtitling API는 YouTube video의 structured subtitle data를 가져와 Agent, content analysis, 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 | 아니요 | - | 자막 language code. 예: en or zh-CN; 생략하면 downstream 서비스가 사용 가능한 언어를 선택합니다 |
with_time | boolean | 아니요 | false | 반환 여부: start and duration 각 자막 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.
- video content의 검색 가능한 텍스트 index를 만듭니다.
- 요약 또는 번역 workflow용 원문 텍스트를 준비합니다.
- Map notes, quotes, or summaries back to timestamps.
참고
- This API does not download video or audio, and it 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 | 나중에 다시 시도하세요 |