Category: service
IMS Video Translation (OpenAPI)
Submit video translation jobs via OpenAPI and poll results for subtitle-level, voice-level, and face-level processing.
Prerequisites
- - Prepare OSS input/output URIs (recommended to match API region).
- Configure AK:
ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID (ALICLOUD_REGION_ID can be used as the default region; if unset, choose the most reasonable region and ask when unclear).
Workflow
1) Prepare source file and output OSS location.
2) Submit job with SubmitVideoTranslationJob.
3) Poll status and result with GetSmartHandleJob.
4) Use ListSmartJobs / DeleteSmartJob for job management when needed.
Level Selection and Parameters
- - Selection rules and fields for subtitle/voice/face levels are in
references/fields.md. - Field examples (Input/Output/EditingConfig) are also in
references/fields.md.
Notes
- - For second-pass editing, set
SupportEditing=true in the first job and reference OriginalJobId later. - Input and output OSS regions must match the OpenAPI invocation region.
- Use longer polling intervals for large jobs to avoid frequent requests.
Validation
CODEBLOCK0
Pass criteria: command exits 0 and output/aliyun-mps-video-translation/validate.txt is generated.
Output And Evidence
- - Save artifacts, command outputs, and API response summaries under
output/aliyun-mps-video-translation/. - Include key parameters (region/resource id/time range) in evidence files for reproducibility.
References
- - Source list: INLINECODE14
技能名称: aliyun-mps-video-translation
详细描述:
类别: 服务
IMS 视频翻译 (OpenAPI)
通过 OpenAPI 提交视频翻译任务，并轮询获取字幕级、语音级和人脸级处理结果。
前提条件
- - 准备 OSS 输入/输出 URI（建议与 API 区域匹配）。
- 配置 AK：ALICLOUDACCESSKEYID / ALICLOUDACCESSKEYSECRET / ALICLOUDREGIONID（ALICLOUDREGIONID 可作为默认区域；若未设置，则选择最合理的区域，不明确时进行询问）。
工作流程
1) 准备源文件和输出 OSS 位置。
2) 使用 SubmitVideoTranslationJob 提交任务。
3) 使用 GetSmartHandleJob 轮询状态和结果。
4) 需要时使用 ListSmartJobs / DeleteSmartJob 进行任务管理。
级别选择与参数
- - 字幕/语音/人脸级别的选择规则和字段见 references/fields.md。
- 字段示例（输入/输出/编辑配置）同样见 references/fields.md。
注意事项
- - 如需二次编辑，在首次任务中设置 SupportEditing=true，后续引用 OriginalJobId。
- 输入和输出 OSS 区域必须与 OpenAPI 调用区域一致。
- 对于大型任务，建议使用较长的轮询间隔，避免频繁请求。
验证
bash
mkdir -p output/aliyun-mps-video-translation
echo validation_placeholder > output/aliyun-mps-video-translation/validate.txt
通过标准：命令退出码为 0，且生成了 output/aliyun-mps-video-translation/validate.txt。
输出与证据
- - 将产物、命令输出和 API 响应摘要保存到 output/aliyun-mps-video-translation/ 目录下。
- 在证据文件中包含关键参数（区域/资源 ID/时间范围），以确保可复现性。
参考资料
- - 来源列表：references/sources.md
