logo

YouTube ASR 解析

提交一个或多个 YouTube 视频链接，返回每个视频的语音转写文本、识别语言与处理状态

数据获取社交媒体YouTube视频

概览

把 YouTube 视频里的口语内容整理成可检索、可统计的文本，是内容研究、字幕整理和多语言分析的基础工作。这个应用接收一批视频链接，为每个视频返回转写文本、识别语言、处理状态和时间信息，让需要逐个播放查找的内容变成可直接筛选和汇总的数据。

批量结果保留视频与文本的对应关系，也标明没有取得有效内容的情况。使用者既能汇总可用文本，也能筛出受限、无字幕或识别失败的视频复核，形成后续分析的原始底表。

数据说明

结果来自本次提交的 YouTube 视频，按清洗更新时间倒序返回，并以提交的视频链接去重。视频时长以毫秒计；「无数据」为“是”时，通常表示视频没有可用字幕或内容受限，转写文本可能为空。时间字段反映内容采集和结果更新的时刻，文档未说明时区。已删除、不可访问或受限内容可能无法得到有效文本。

结果长什么样

每条记录代表一个提交的视频及其解析结果：

视频链接视频时长识别状态输入语言输出语言转写文本
https://www.youtube.com/watch?v=gi6m9vl1CkA2941000有效enenWell, hello and welcome back to Poshcast Camping.
https://www.youtube.com/watch?v=3OFHRTWzBf8180000有效enzh-Hans大家好，欢迎回到今天的节目。

另有「无数据」「视频编号」「识别说明」「更新时间」和「采集时间」等字段。

应用场景

  • 做视频主题研究时，从「转写文本」提取高频词、品牌名与观点，再用「视频链接」核验上下文。
  • 整理多语言字幕素材时，对照「输入语言」「输出语言」和「转写文本」，筛出需要人工校对的记录。
  • 做批量质量检查时，结合「识别状态」「识别说明」与「无数据」，统计覆盖率并定位受限视频。

适用边界

单次任务可提交 1–200 个 YouTube 视频；输出语言支持简体中文、繁体中文、英语、德语、日语和韩语；无可用字幕或内容受限的视频可能没有转写文本。

  • 适合用于
  • 需要批量获取 YouTube 视频的语音转写文本时
  • 需要按指定语言整理视频口语内容，用于内容分析或字幕素材准备时
  • 不要用于
  • 需要解析非 YouTube 来源的音视频时
  • 需要保证每个受限视频都能得到完整文本时——无可用字幕或内容受限的视频可能返回无数据

失败处理

开发者声明的失败与重试处理方式，接入时建议一并写进系统提示词。

  1. 1返回无数据时，先确认视频仍可访问且具有可解析的语音或字幕内容，再原样重试
  2. 2限流、服务暂不可用或请求超时可稍后重试；鉴权失败需先检查执行环境中的凭证配置
  3. 3任务部分成功时会保留已完成的视频结果；任务失败或过期后可原样重新提交

输入参数

调用本 App 需要传入的参数，与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
items视频清单array<object>是—最多 200 项[{"kw":"https://www.youtube.com/watch?v=eRoFLDAlCbY","language":"en"}]要解析的 YouTube 视频列表，每项填写视频链接，并可单独指定输出语言；一次提交 1–200 个视频

输出数据

单条记录的字段结构，与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
video_url视频链接string—本次任务提交的 YouTube 视频链接，用作记录唯一标识
no_data无数据boolean—该视频是否未获得有效解析结果
content_id视频编号string—YouTube 视频内容编号
content_url内容链接string—解析结果关联的 YouTube 视频链接
asr_text转写文本string—从视频语音或可用字幕中解析出的文本内容
input_language输入语言string—识别到或用于处理的原始内容语言
output_language输出语言string—转写文本使用的输出语言
video_duration_ms视频时长integer—视频总时长，单位为毫秒
recognition_status识别状态string—视频语音或字幕内容的识别结果状态
recognition_message识别说明string—识别成功、无可用字幕或受限等结果说明
file_url文件链接string—解析服务返回的关联文件链接
clean_update_time更新时间string—解析结果完成清洗更新的时间
crawl_time采集时间string—视频内容被采集处理的时间

记录 Schema

输出按记录逐条返回。记录主键为 video_url，去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "title": "视频链接",
      "description": "本次任务提交的 YouTube 视频链接，用作记录唯一标识"
    },
    "no_data": {
      "type": "boolean",
      "title": "无数据",
      "description": "该视频是否未获得有效解析结果"
    },
    "content_id": {
      "type": "string",
      "title": "视频编号",
      "description": "YouTube 视频内容编号"
    },
    "content_url": {
      "type": "string",
      "title": "内容链接",
      "description": "解析结果关联的 YouTube 视频链接"
    },
    "asr_text": {
      "type": "string",
      "title": "转写文本",
      "description": "从视频语音或可用字幕中解析出的文本内容"
    },
    "input_language": {
      "type": "string",
      "title": "输入语言",
      "description": "识别到或用于处理的原始内容语言"
    },
    "output_language": {
      "type": "string",
      "title": "输出语言",
      "description": "转写文本使用的输出语言"
    },
    "video_duration_ms": {
      "type": "integer",
      "title": "视频时长",
      "description": "视频总时长，单位为毫秒"
    },
    "recognition_status": {
      "type": "string",
      "title": "识别状态",
      "description": "视频语音或字幕内容的识别结果状态"
    },
    "recognition_message": {
      "type": "string",
      "title": "识别说明",
      "description": "识别成功、无可用字幕或受限等结果说明"
    },
    "file_url": {
      "type": "string",
      "title": "文件链接",
      "description": "解析服务返回的关联文件链接"
    },
    "clean_update_time": {
      "type": "string",
      "title": "更新时间",
      "description": "解析结果完成清洗更新的时间"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "视频内容被采集处理的时间"
    }
  },
  "required": [],
  "additionalProperties": false
}

调用方式

本 App 支持通过 MCP、API、SDK 与文件导出方式接入，各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证，凭证为 API Key（长期有效，在开放平台创建）；MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。

通过 MCP（Model Context Protocol）协议，可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式，复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可，各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "mona_kk__youtube-asr": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-asr",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

毫秒视频

按输出字段 video_duration_ms 求和计量，任务失败不计费。每 60000 毫秒视频为一个计费单位，不足 60000 毫秒视频按 60000 毫秒视频计。

¥0.1/ 60000 毫秒视频
提交一次任务

每提交一次任务计费一次，与返回条数无关。

¥0.04/ 次

多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。

查看余额

立即体验

填写参数直接运行，结果来自真实调用。

示例
参数按 input.schema 校验后提交
登录后返回，确认参数再提交运行。
¥0.04 / 次