OpenAPI 文档/YouTubeGET

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_idstring否11 位视频 ID。与 video_url 至少传一个
video_urlstring否视频页链接。已传 video_id 时忽略
language_codestring否语言代码,如 en、zh-Hans。留空则只返回列表。自动字幕代码以 a. 开头
formatstring否srt(默认)、txt、xml 或 json3。txt 没有时间轴

响应字段说明

字段类型说明
codeint业务状态码,200 表示成功
request_idstring本次请求唯一标识,排查问题时可提供
dataobject业务数据容器,具体字段见下
data.captionsarray未指定语言时的列表。每项含 language_code、language_name。空数组表示没有自带字幕
data.content / text / subtitle / caption / transcriptstring指定语言后,正文在这几个字符串字段之一;有时 data 本身就是字幕文本
data.statusstring大视频为 processing
data.job_idstring交给「字幕结果」的任务 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 调用接口。