設定 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 | 下游字幕服務失敗或不可用 | 稍後重試 |