用途:在阿里云智能媒体服务(IMS)中,通过 OpenAPI 创建和管理视频翻译任务,覆盖字幕级、语音级和画面级三种处理深度,适合以 API 方式自动化完成视频翻译。
主要能力:提交视频翻译任务;轮询任务状态与结果;按需列出和删除任务。支持二次编辑流程,首次任务设置 SupportEditing=true,后续通过引用 OriginalJobId 进行再加工。
使用方式:先准备 OSS 输入与输出地址,建议与 API 区域保持一致。配置访问凭证 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、ALIBABACLOUD_REGION_ID;REGION_ID 可作为默认区域,未设置时应选择最合理区域,不确定时需先确认。提交任务使用 SubmitVideoTranslationJob,查询状态与结果使用 GetSmartHandleJob,任务管理使用 ListSmartJobs / DeleteSmartJob。各处理级别(字幕/语音/画面)的选择规则、字段说明以及 Input、Output、EditingConfig 的字段示例,见 references/fields.md。
适用场景:需要批量或程序化地完成视频翻译,并在字幕、语音、口型等不同层面处理的业务。
限制与注意事项:输入与输出的 OSS 区域必须与 OpenAPI 调用区域一致;大型任务应使用较长轮询间隔,避免频繁请求。
验证与产出:可通过 mkdir -p output/aliyun-mps-video-translation 与 echo "validation_placeholder" > output/aliyun-mps-video-translation/validate.txt 进行验证,通过标准为命令退出码为 0 且生成该文件;产物、命令输出和 API 响应摘要应保存在 output/aliyun-mps-video-translation/ 下,并在证据文件中包含区域、资源 ID 和时间范围等关键参数。其他价格、配额等事实暂未提供。