概览
把 YouTube 视频里的口语内容整理成可检索、可统计的文本,是内容研究、字幕整理和多语言分析的基础工作。这个应用接收一批视频链接,为每个视频返回转写文本、识别语言、处理状态和时间信息,让需要逐个播放查找的内容变成可直接筛选和汇总的数据。
批量结果保留视频与文本的对应关系,也标明没有取得有效内容的情况。使用者既能汇总可用文本,也能筛出受限、无字幕或识别失败的视频复核,形成后续分析的原始底表。
数据说明
结果来自本次提交的 YouTube 视频,按清洗更新时间倒序返回,并以提交的视频链接去重。视频时长以毫秒计;「无数据」为“是”时,通常表示视频没有可用字幕或内容受限,转写文本可能为空。时间字段反映内容采集和结果更新的时刻,文档未说明时区。已删除、不可访问或受限内容可能无法得到有效文本。
结果长什么样
每条记录代表一个提交的视频及其解析结果:
| 视频链接 | 视频时长 | 识别状态 | 输入语言 | 输出语言 | 转写文本 |
|---|---|---|---|---|---|
| https://www.youtube.com/watch?v=gi6m9vl1CkA | 2941000 | 有效 | en | en | Well, hello and welcome back to Poshcast Camping. |
| https://www.youtube.com/watch?v=3OFHRTWzBf8 | 180000 | 有效 | en | zh-Hans | 大家好,欢迎回到今天的节目。 |
另有「无数据」「视频编号」「识别说明」「更新时间」和「采集时间」等字段。
应用场景
- 做视频主题研究时,从「转写文本」提取高频词、品牌名与观点,再用「视频链接」核验上下文。
- 整理多语言字幕素材时,对照「输入语言」「输出语言」和「转写文本」,筛出需要人工校对的记录。
- 做批量质量检查时,结合「识别状态」「识别说明」与「无数据」,统计覆盖率并定位受限视频。
适用边界
单次任务可提交 1–200 个 YouTube 视频;输出语言支持简体中文、繁体中文、英语、德语、日语和韩语;无可用字幕或内容受限的视频可能没有转写文本。
- 适合用于
- 需要批量获取 YouTube 视频的语音转写文本时
- 需要按指定语言整理视频口语内容,用于内容分析或字幕素材准备时
- 不要用于
- 需要解析非 YouTube 来源的音视频时
- 需要保证每个受限视频都能得到完整文本时——无可用字幕或内容受限的视频可能返回无数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回无数据时,先确认视频仍可访问且具有可解析的语音或字幕内容,再原样重试
- 2限流、服务暂不可用或请求超时可稍后重试;鉴权失败需先检查执行环境中的凭证配置
- 3任务部分成功时会保留已完成的视频结果;任务失败或过期后可原样重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 视频清单
items必填array<object>要解析的 YouTube 视频列表,每项填写视频链接,并可单独指定输出语言;一次提交 1–200 个视频数量最多 200 项示例[{"kw":"https://www.youtube.com/watch?v=eRoFLDAlCbY","language":"en"}]
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 视频链接
video_urlstring本次任务提交的 YouTube 视频链接,用作记录唯一标识 - 无数据
no_databoolean该视频是否未获得有效解析结果 - 视频编号
content_idstringYouTube 视频内容编号 - 内容链接
content_urlstring解析结果关联的 YouTube 视频链接
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-asr",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按输出字段 video_duration_ms 求和计量,任务失败不计费。每 60000 毫秒视频为一个计费单位,不足 60000 毫秒视频按 60000 毫秒视频计。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。