YouTube — 自带字幕
SpiderHubs OpenAPI 文档:YouTube — 自带字幕,分类 YouTube。接口 GET /openapi/v1/contentcreator/youtube/web_v2/get_video_captions。读取视频上已经存在的字幕。不传 language_code 时返回语言列表;传...
OpId:
yt-captions · 最近更新: 2026-11-19说明
读取视频上已经存在的字幕。不传 language_code 时返回语言列表;传入后返回该语言正文。没有字幕时仍返回 200,并按成功计 1 积分。大视频可能返回 status=processing 和 job_id,再用「字幕结果」取回。本接口不做语音识别。口播转写请用字幕提取 API。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/youtube/web_v2/get_video_captions
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_id | string | 否 | 11 位视频 ID。与 video_url 至少传一个 |
| video_url | string | 否 | 视频页链接。已传 video_id 时忽略 |
| language_code | string | 否 | 语言代码,如 en、zh-Hans。留空则只返回列表。自动字幕代码以 a. 开头 |
| format | string | 否 | srt(默认)、txt、xml 或 json3。txt 没有时间轴 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码,200 表示成功 |
| request_id | string | 本次请求唯一标识,排查问题时可提供 |
| data | object | 业务数据容器,具体字段见下 |
| data.captions | array | 未指定语言时的列表。每项含 language_code、language_name。空数组表示没有自带字幕 |
| data.content / text / subtitle / caption / transcript | string | 指定语言后,正文在这几个字符串字段之一;有时 data 本身就是字幕文本 |
| data.status | string | 大视频为 processing |
| data.job_id | string | 交给「字幕结果」的任务 ID |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/youtube/web_v2/get_video_captions?video_id=ZFEnfscZpAU' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "f66b1209-8a40-4d55-91ce-2b7e44aa0918",
"data": {
"video_id": "ZFEnfscZpAU",
"captions": [
{ "language_code": "en", "language_name": "English" },
{ "language_code": "zh-Hans", "language_name": "Chinese (Simplified)" }
]
}
}开始调用 SpiderHubs API
使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。