YouTube 字幕 API
通过一次 POST 从任何公开 YouTube 视频提取字幕轨道。响应返回带逐段时间戳的完整转录文本。
- 一次 POST，一份转录
- 人工与自动字幕
- 逐段时间戳
- 所有公开链接形式
- 幂等键支持
- 需要服务器端密钥
请求示例
curl "https://api.agentbody.io/v1/youtube/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&language=en" \
-H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"响应示例
来自 OpenAPI 规范的已文档化响应。
Existing captions or explicitly requested audio transcription.
{
"caption_type": "manual",
"language": "example_value",
"segments": [],
"text": "example_value",
"video_id": "example_value"
}功能特点
youtube.transcript 操作从一个公开 YouTube 视频提取现有字幕轨道。您的服务器持有 API 密钥；端点在单次调用中返回完整转录。
一次 POST，一份转录
发送 POST /v1/youtube/transcript 和公开视频 URL。成功的 200 返回 video_id、caption_type、language、含 start/duration/text 的 segments 以及拼接的完整文本——转录管道所需的一切。
人工与自动字幕
API 同时返回人工字幕轨道和自动生成轨道。存在多条轨道时可指定语言；响应报告实际使用的 caption_type。
逐段时间戳
每段携带起始时间和时长（秒）及文本，下游代码可精确引用时刻、构建字幕或对齐播放。
所有公开链接形式
Watch 页面、youtu.be 短链、Shorts 和嵌入 URL 均可解析。私密、已删除和年龄限制视频返回错误而非转录。
幂等键支持
传递 Idempotency-Key 头安全重试失败请求。网关按键去重，网络重试不会触发第二次提取或扣费。
需要服务器端密钥
端点需要服务器持有的 AgentBody API 密钥。绝不将密钥发到客户端；通过后端路由调用。
使用步骤
三步 API 集成 YouTube 转录提取。
获取 API 密钥
创建免费 AgentBody 账户并从仪表板生成 API 密钥。
POST 视频 URL
向 /v1/youtube/transcript 发送 POST 请求和公开视频 URL 及可选语言偏好。包含 Idempotency-Key 头以安全重试。
接收转录
200 返回 caption_type、language、逐段时间戳和完整文本。存储、索引或流式传给摘要工具。
常见问题
YouTube 字幕 API 如何工作？
向 /v1/youtube/transcript 发送 POST 请求和公开视频 URL。API 获取视频字幕轨道——人工或自动生成——并在单次响应中返回带逐段时间戳的完整文本。
支持哪些视频？
任何带字幕轨道的公开视频。私密、已删除、年龄限制视频以及上传者关闭字幕的视频返回错误且不计费。
响应包含什么？
video_id、caption_type（人工或自动）、language、segments 数组（每段含 start 秒、duration 秒、text）以及拼接的完整转录文本。
可以指定语言吗？
可以。视频有多语言字幕轨道时，传递所需语言；API 提取该轨道并在响应中报告实际使用的是哪条。
如何计费？
每次成功提取按网关管理价格从您的 AgentBody 余额扣除固定金额。失败请求不计费；Idempotency-Key 头防止重试重复扣费。
有速率限制吗？
除账户余额外无单独速率限制。每次请求按公布的固定价格一次提取。