YouTube API
YouTube 文稿 API 优先使用创作者字幕，每条字幕都带时间
一个端点覆盖 YouTube 视频和 Shorts。优先使用创作者字幕，每条字幕都带时间。
1.0功能
核心优势 以及随之而来的限制
获取 YouTube 视频和 Shorts 的创作者字幕，按时间分段返回；没有字幕的视频，付费套餐可使用 AI 转录。
运营限制与透明说明
- 单区域基础设施，部署在美国东部。
- 价格：每份字幕文稿 1 个点数，AI 转录每开始一分钟 2 个点数，都从同一个余额中扣除。
- 每个来源的媒体时长上限为 2 小时（7,200 秒）。
2.0实现
请求与响应 具体的请求以及返回的内容
POST/v1/jobs
curl -X POST https://www.transcriptdock.com/v1/jobs \-H "Authorization: Bearer td_live_..." \-H "Content-Type: application/json" \-H "Idempotency-Key: $(uuidgen)" \-d '{"source": {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"mode": "captions_only","caption_preference": "prefer_creator"}'
任务结果
{"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b","status": "succeeded","stage": null,"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f","error": null,"billing": {"credits_reserved": 0,"credits_charged": 1,"kind": "captions"},"source": {"platform": "youtube","media_id": "dQw4w9WgXcQ","canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ","title": "Sample YouTube Video","upload_id": null},"options": {"mode": "captions_only","language": null,"caption_preference": "prefer_creator"},"created_at": "2026-09-12T14:32:00Z"}
3.0问题
常见问题
此来源在字幕、AI 转录和限制方面的情况。
API 如何处理没有字幕的视频？
当 mode 设为 auto 时，系统会先查找创作者字幕。如果没有，就会安全地获取音频并运行 AI 转录，生成带时间戳的文稿。
可以只请求字幕，以避免 AI 转录费用吗？
可以。把 mode 设为 captions_only，就能保证不会运行任何 AI 转录流程，提取成本可预测且较低。
支持 YouTube Shorts 吗？
支持。标准的 youtube.com watch 链接和 youtube.com/shorts 网址都会被规范化并转录。