# YouTube 转写 API：把视频字幕变成纯文本

把一个 YouTube 链接交给 agent，就能拿回口述内容的文本，可直接用于摘要、检索或引用。3 款工具都通过 鹦鹉AI 完成这件事，每个视频低至 1.16 积分/成功。官方的 YouTube Data API 无法处理不属于你的视频，这正是这个任务需要花钱的全部原因。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「使用 鹦鹉AI，获取 https://www.youtube.com/watch?v=dQw4w9WgXcQ 的英文转写文本。先告诉我价格，然后把它总结成五个要点。」

- **直接给它链接** 两款工具都接受 watch 或 Shorts 链接，不需要先查视频 ID。
- **指明语言** 要一个你确定视频有的语言，否则会拿到空结果。
- **先问价格** 鹦鹉AI 会在调用前返回费用，所以 agent 能先说明这次要花多少钱。
- **说明拿它做什么** 一轮里同时要转写文本和下一步指令，比先取回再粘贴更高效。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `crawl4ai.youtube.video.captions` — 某 YouTube 视频的字幕 (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.x.youtube-web-v2-get-video-captions` — 按视频 ID 或 URL 查询 YouTube 视频字幕 (youtube): https://parrot.amorist.cn/catalog/youtube
- `scrapecreators.x.v1-youtube-video-transcript` — 按 URL 获取 YouTube 视频文字稿 — 字幕、文本 (youtube): https://parrot.amorist.cn/catalog/youtube

## 大家实际卡在哪

这个任务有大量且异常坦诚的讨论，因为所有人一开始都是自己动手做。我们从 2026 年 8 月 Reddit 和 X 上约 180 条帖子中，剔除了十三个推广与自我推广账号群（约占语料的一半），整理出这五条反复出现的说法。

**在笔记本上能用，一上服务器就挂**

> "我试着在云上跑的时候，YouTube 好像把 IP 封了。" (r/SaaS, 5 points: https://www.reddit.com/r/SaaS/comments/1fgjjd1/looking_for_a_saas_tool_to_fetch_youtube_video/)

这一页能帮上的： 这是整个调研里重复出现最多的失败，而且是结构性的：非官方路线从你的地址读取，机房网段会被封。通过 鹦鹉AI 的调用则是从工具自己的基础设施出去。没有哪家工具能保证它的 IP 池在今天、在你这个量级下干不干净。

**没人能保证它下个月还能用**

> "总感觉 YouTube 那边一有变动，整个功能随时都会挂掉" (r/sideprojects, 5 points: https://www.reddit.com/r/sideprojects/comments/1v4zk6t/is_there_a_stable_way_to_pull_youtube_transcripts/)

这一页能帮上的： 没错，谁也没法告诉你相反的话。诚实的区别在于谁来负责修：非官方路线是你，在它坏掉的那一刻；在这里是工具，失败表现为一条账单记录，而不是一次服务中断。

**代理才是自己动手的真正成本**

> "它需要轮换 IP 地址（因为 YouTube 会封字幕抓取），所以我搭了个 webshare 代理（大概 2100 积分）" (r/n8n, 285 points: https://www.reddit.com/r/n8n/comments/1pd5gbx/turn_any_youtuber_into_an_ai_agent_001run_using/)

这一页能帮上的： 这是个合理的参照，值得拿来算笔账：代理是一笔每月固定支出，不管你取不取字幕都要付，还要加上维护。这里的价格是按视频计费、没有固定门槛，量小时更划算，量极大时反而不如它。

**agent 看不了视频，所以字幕就是适配层**

> "在我的应用里通过 API 让 agent 从 YouTube 视频自动生成字幕，最好的办法是什么" (@waynesutton on X: https://x.com/i/status/2087026783615168992)

这一页能帮上的： 这个说法是调研里最大的一条主线，十二条帖子。在这里它就是一次调用：agent 把网址变成文字，然后在同一轮里做真正的工作，这一页顶部的提示词做的就是这件事。

**大家为这个自己搭的集成总是用不长**

> "我用 API 之类的东西搭了几个 MCP，但用来拉字幕效果不太好。" (r/OpenAI, 25 points: https://www.reddit.com/r/OpenAI/comments/1uq73nr/youtube_transcript_getter_extension_for_obsidian/)

这一页能帮上的： 值得把原因说准，因为问题不在 MCP 那一层。问题在于底下那个字幕来源是非官方的。对那两个付费工具来说，这一点在这里没有改变；改变的是维护它成了它们的工作，而且你能比较它们在失败的那个视频上怎么收费。

## 真正不一样的地方

- Google 自家的 Data API 有意没有列入。它的 captions.download 方法只对已连接账号自己拥有的视频有效，读不了别人的视频，这也是为什么平台在播放器里免费提供的能力，在这里要花钱。
- ScrapeCreators 支持 cache_max_age 参数：如果缓存副本比你传入的天数更新，它就返回缓存，而不是重新抓取。对同一批视频重跑时，这就是快速返回与重新抓取的区别。
- 要视频确实拥有的语言。ScrapeCreators 在你传入的两字母语言代码不存在时返回 transcript: null，而不是回退到其他语言；TikHub 则在你完全不传语言代码时返回可用字幕轨列表，这是更稳妥的第一次调用。

## 什么是 YouTube 转写 API？

它返回 YouTube 已经为视频保存的字幕轨：语音识别器生成的自动字幕，或频道上传的人工字幕。你拿到的是文本，通常带时间戳，格式可以是 SRT、纯文本或 JSON。它不是语音转写；这里没有任何工具对音频运行语音识别，所以没有字幕轨的视频就没有内容可返回。

## 开始之前

**一个 YouTube 转写要多少钱？** 每个视频不到 1 积分，按各工具自己的费率计费。其中一款工具只在成功时计费，另一款按尝试计费。

**为什么不自己用 youtube-transcript-api？** 可以，但它能用，直到不能用为止：这个库会从你的 IP 读取一个未公开的接口，而数据中心 IP 段会被屏蔽——这是所有人从笔记本迁移到服务器时都会撞上的失败。这些工具有自己的 IP 池，失败会变成一行账单，而不是一次服务中断。

**支持 Shorts 和直播吗？** Shorts 支持，两款工具都接受 Shorts 链接。直播只有在录制处理完成后才有字幕；频道关闭了字幕的视频，出多少钱都没有字幕轨可返回。

**可以批量获取转写文本吗？** 可以，每个视频一次调用，你把清单交给 agent 即可。没有批量接口，所以成本是线性的。

HTML 版本： https://parrot.amorist.cn/use-cases/youtube-transcript-api