Toucora RAG 与 AI 智能体
无需自行抓取字幕，即可把干净、带时间戳的文字稿送入嵌入、向量数据库和 LLM 流水线。
开发者基础设施
开发者真正需要的 YouTube 文字稿 API
一个 REST API，从公开的 YouTube 视频、播放列表和频道获取结构化文字稿。可预测的额度、机器可读的输出、清晰的错误。免费开始。
Request
# quickstart.sh curl "https://api.example.com/v1/transcripts/VIDEO_ID" \ -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"duration": 213,
"segments": [
{ "text": "...", "start": 18.64, "duration": 3.24 }
]
}
你需要的每一种格式
直接请求你已在使用的格式。响应稳定且带时间戳，后续工具无需猜测。
Transcripts
Single video, batch up to 50, playlists and channels. JSON, TXT, SRT, VTT, Markdown.
GET /v1/transcripts/{videoId}
Jobs & webhooks
Large requests become asynchronous jobs with per-item status, retries and webhooks.
POST /v1/jobs
AI endpoints
Grounded answers with timestamps, summaries and chapters. Small and focused at launch.
POST /v1/ask
为真实的文字稿工作负载而建
研究与分析
一次任务即可拉取整个播放列表或频道的文字稿，然后分析主题、情感或发言时长。
字幕与无障碍
导出 SRT、VTT 或纯文本，用于发布字幕、构建无障碍档案，或把视频改写为文章。
自动化与工具
把文字稿接入 MCP 服务器、Claude Code 和 Codex，让你的智能体按需读取任意视频。
Pricing
Limits are configuration-driven and may change as the API stabilises.
Authentication
Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY
Keys are hashed at rest, shown once, revocable, and scoped per account.
Errors you can handle
{
"error": {
"code": "TRANSCRIPT_NOT_AVAILABLE",
"message": "...",
"request_id": "req_123"
}
}
Every request carries an X-Request-ID for support and debugging.
OpenAPI
The canonical schema is published and importable into Postman and other tooling.
常见问题
有免费的 YouTube 文字稿 API 吗？
有。每个账户获赠 10,000 免费额度和一个开发者密钥，无需信用卡。每个视频消耗 1 个额度，因此可以在不付费的情况下开发与测试。
如何用 API 获取 YouTube 文字稿？
在 Authorization 头中带上密钥，调用 GET /v1/transcripts/{videoId}。你会得到文字稿、语言、时长和带时间戳的片段（JSON）。
API 支持其他语言的字幕吗？
支持。先用 GET /v1/transcripts/{videoId}/languages 列出字幕轨道，再传 ?lang= 获取所需语言。自动字幕会标注以便判断质量。
API 返回哪些输出格式？
JSON、TXT、SRT、VTT 和 Markdown。在文字稿请求中用 ?format=，或自行转换 JSON——片段是文本加开始时间与时长。
有 Python 示例吗？
有。用 requests 或 httpx 几行即可，博客指南提供了含批处理与重试的 Python 快速上手。
能获取整个播放列表或频道吗？
可以。向 POST /v1/transcripts 发送最多 50 个视频 ID，或启动播放列表/频道任务，按视频返回结果与状态。
有面向 YouTube 文字稿的 MCP 服务器吗？
有。MCP 服务器向 Claude Code、Codex 等 MCP 客户端暴露文字稿工具，智能体无需定制代码即可读取视频。
费用是多少？
早期访问期间 API 免费：每个账户 10,000 额度，每分钟 60 次请求。更高额度的付费计划即将推出。