配置 Harness
YouTube Subtitling API
获取 YouTube 字幕，支持可选语言和时间戳参数。
YouTube Subtitling API 用于获取 YouTube 视频的结构化字幕数据，让 Agent、内容分析、教育产品、搜索索引和总结/翻译工作流可以直接使用视频文本。
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 或 zh-CN；不传时由下游服务选择可用语言 |
with_time | boolean | 否 | false | 是否返回每条字幕的 start 和 duration |
响应 Fields
| 字段 | 类型 | 说明 |
|---|---|---|
data.title | string | YouTube 视频标题 |
data.contents | array | 字幕条目列表 |
data.contents[].start | number | 字幕开始时间，单位秒 |
data.contents[].duration | number | 字幕持续时间，单位秒 |
data.contents[].text | string | 字幕文本 |
示例
curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en&with_time=true" \
-H "Authorization: Bearer YOUR_API_KEY"使用场景
- 让 Agent 在回答问题前理解 YouTube 视频内容
- 为视频内容建立可搜索文本索引
- 为总结、翻译或研究工作流准备 source text
- 把笔记、引用和摘要映射回时间戳
说明
- 该 API 不下载视频或音频。
- 它返回已有字幕，不会为没有字幕的视频生成字幕。
- 某些视频可能没有字幕，或没有请求语言的字幕。
Error Responses
| HTTP Status | Error Code | 说明 | 建议操作 |
|---|---|---|---|
| 400 | YOUTUBE_SUBTITLING_FAILED | 参数错误、视频不存在、字幕不可用或下游客户端错误 | 检查 video_code、字幕可用性和 language |
| 401 | INVALID_API_KEY | API key 缺失、无效或已撤销 | 检查 API key 和 authorization header |
| 500 | YOUTUBE_SUBTITLING_FAILED | 内部服务错误 | 重试；持续失败请联系 support |
| 502 | YOUTUBE_SUBTITLING_FAILED | 下游字幕服务失败或不可用 | 稍后重试 |