YouTube 字幕接口

用链接或视频编号取任意公开 YouTube 视频的完整字幕：语言、全文，以及每一段的开始和结束时间。它是 YouTube 详情调用加上 `include=transcript`，每个视频 2 积分（约 ¥0.05），失败不扣。可以用 HTTP 调用，也可以让 AI 通过 MCP 调用。

能拿到什么

每个视频一个对象。视频用视频链接：watch、shorts、embed、live 或 youtu.be 的写法或视频编号指定。

字段	类型	含义
`fields.lang`	string	逐字稿的语言。
`fields.text`	string	全文。
`fields.segments`	array	带时间的分段：start、end、text。

请求

curl https://api.socialtoai.com/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "youtube",    "id": "dQw4w9WgXcQ",    "include": "transcript"  }'

import osimport uuidimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/detail",    headers={        "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}",        # A new key for each request; the same one again retries it without paying twice.        "Idempotency-Key": str(uuid.uuid4()),    },    json={        "platform": "youtube",        "id": "dQw4w9WgXcQ",        "include": "transcript",    },)print(response.json())

一次录制的返回（名称和正文已去掉）

{  "request_id": "req_00000000-0000-4000-8000-000000000001",  "schema_version": "v1",  "fetched_at": "2026-10-12T03:34:28.000Z",  "action": "detail",  "platform": "youtube",  "status": "ok",  "items": [    {      "platform": "youtube",      "id": "…",      "ref": "…",      "approx": [],      "type": "entry",      "entry_type": "transcript",      "title": null,      "url": null,      "rank": null,      "heat": null,      "fields": {        "lang": "en",        "text": "…",        "segments": [          {            "start": 0.4,            "end": 4.24,            "text": "…"          },          {            "start": 2.08,            "end": 6.56,            "text": "…"          }        ]      }    }  ],  "unavailable": [],  "warnings": [],  "applied_params": {    "id": "dQw4w9WgXcQ",    "include": "transcript"  },  "cost_credits": 2,  "billing": {    "cost_credits": 2,    "balance_credits": 98,    "today_spend_credits": 2,    "daily_limit_credits": null,    "daily_remaining_credits": null,    "display": "本次 2 积分（约 $0.0067），余额 98 积分（约 $0.33）"  },  "replayed": false}

YouTube 官方 API 能给什么

YouTube 官方 Data API 只能为登录用户下载他有编辑权限的视频的字幕，并按次扣配额；任意公开视频的字幕它不给。

官方 API	谁能用	费用	限制	来源
YouTube Data API v3	有 Google Cloud 项目和 API Key 的开发者。	配额内免费：默认每天 100 次 search.list，其余接口合计 10,000 单位。	读一个列表通常 1 单位；要更多配额得填 Google 的配额扩展申请表。	developers.google.com，核对于 2026-10-29
字幕下载（captions.download）	对视频有编辑权限、已登录授权的用户。	每次 200 配额单位。	只能下载自己能编辑的视频的字幕，任意公开视频不行。	developers.google.com，核对于 2026-10-29