开发者 / MCP
在 AI 工作流中处理视频翻译。
通过七个 MCP 工具准备和跟进翻译。分享哪段视频、确认哪份报价、下载哪些文件,仍由你决定。
连接、确认,再跟进成果
远程 MCP 地址
https://aitrans.video/api/ai先确认客户端条件
客户端需要支持远程 MCP 和本站的 OAuth 流程,并由运营方登记。请通过联系页面提供产品名称、版本和准确的回调地址。目前不提供动态注册;本指南不代表所有客户端都已兼容。
在浏览器中授权
使用下方地址,按客户端的正常 OAuth 连接流程操作,在网站登录并核对请求的访问权限。连接不等于分享全部历史任务,也不代表同意付费。不要在聊天中粘贴网站 Cookie、访问令牌或刷新令牌。
分享视频并确认报价
先读取当前配置,使用工具返回的音色 ID。申请上传链接后,在网站选择并分享视频。素材验证完成后准备翻译,打开原报价确认链接。只有在网站批准同一份报价后才能创建任务;修改配置需要重新报价和确认。
保留原始标识
只提交已确认的意图,之后继续查询同一意图或任务。遵循 poll_after_seconds,并有界退避。UNKNOWN 或响应丢失不表示可以再建任务或再次付费提交。权限被拒绝或撤销时应先处理授权问题,不要反复创建。
当前 MCP 可创建的范围
示例使用英语。先查询当前 target_languages,再选择 target_language 和该 selected_target_language 返回的音色;界面语言与检测到的源语言独立处理。语言可用不代表已批准花费,网站其他设置也不会自动通过 MCP 开放。
- 素材
- verified_media
- 源语言
- auto
- 目标语言
- 从当前 target_languages 选择
- 模式
- express
- 请求输出
- editor
七个工具,跟进同一任务
展开工具可查看参数。下列 ID 和请求键均为虚构示例,请使用你有权访问的请求实际返回的值。示例音色 ID 必须替换为 get_translation_options 返回的音色 ID。
get_translation_options读取支持的配置和可用的官方预设音色。
参数示例
{}request_translation_upload获取网站上传链接,由你选择并分享视频。
参数示例
{
"request_key": "example-upload-001"
}get_translation_upload查询原上传请求,等待素材验证完成。
参数示例
{
"request_id": "11111111-1111-4111-8111-111111111111"
}prepare_translation获取服务端报价和网站确认链接;这一步不会批准付费或创建任务。
参数示例
{
"request_key": "example-prepare-001",
"request": {
"source": {
"type": "verified_media",
"value": "22222222-2222-4222-8222-222222222222"
},
"source_language_mode": "auto",
"target_language": "en",
"service_mode": "express",
"preset_voice_id": "example-use-returned-voice-id",
"translation_preferences": null,
"requested_outputs": [
"editor"
]
}
}create_translation提交原来已在网站确认的任务意图。
参数示例
{
"intent_id": "33333333-3333-4333-8333-333333333333"
}get_translation按意图、请求键或任务查询原请求,每次只提供一种查询标识。
参数示例
{
"translation_id": "job_example_001"
}get_translation_result读取项目和符合条件的下载链接,以及有界的成果元数据。
参数示例
{
"translation_id": "job_example_001",
"language": "en"
}按实际状态领取成果
任务创建成功不等于媒体处理完成。请打开项目链接查看进度,并完成必要的网站操作。生成草稿、解锁、编辑和另存仍需在网站明确操作;工具不会自动购买或生成草稿。
下载链接需要在已登录网站的浏览器中打开,仍会检查当前归属、资金、权益和输出版本。返回链接不等于授予下载凭据,也不保证文件已经可领取。
result_generation 是符合条件任务的编辑版本;无法验证时为 null。它不是内容哈希,也不能证明同版本重新生成。格式和角色只是输出声明;实际语言未知或冲突时仍为 null。默认调用不返回字幕正文或音频;可选的有界已发布译文字幕需要独立 translations:subtitles:read 同意及原授权的任务访问资格,详情见纯文本指南。
draft_outputs 最多返回两条已持久化的草稿事实,freshness 始终为 unverified;状态不证明文件存在或有下载权限。请在网站按 next_action 继续,needs_review 尤其需要 review_on_website。
成果元数据示例
{
"result_generation": 0,
"download": {
"key": "publish.dubbed_video",
"format": "mp4",
"role": "dubbed_video",
"language": "en"
}
}草稿状态示例
{
"draft_format": "jianying",
"status": "needs_review",
"warning": "compatibility_needs_review",
"freshness": "unverified",
"next_action": "review_on_website"
}已有验证的边界
一次 ChatGPT 工作流已用自有的约 13 秒短片走通七个工具,范围为自动识别源语言(实际识别为英语)、英语目标、Express 和预设音色。复用原媒体和时标重建后,用户于 2026 年 10 月 15 日在 Windows 剪映 11.6.0.14552 验收了原样解压的 ZIP。这只是特定短样片的结果,不代表所有语言、模式、音色、客户端或桌面版本均已验收。
准确的 OAuth 元数据、恢复规则和客户端接入说明见纯文本指南。如果刷新授权被拒绝,请通过客户端的浏览器流程重新连接,不要手动替换凭据。
阅读纯文本指南