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/alicloud-media-video-translation/validate.txt is generated.
Output And Evidence
- - Save artifacts, command outputs, and API response summaries under
output/alicloud-media-video-translation/. - Include key parameters (region/resource id/time range) in evidence files for reproducibility.
References
- - Source list: INLINECODE14
技能名称: alicloud-media-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/alicloud-media-video-translation
echo validation_placeholder > output/alicloud-media-video-translation/validate.txt
通过标准：命令退出码为0，且生成output/alicloud-media-video-translation/validate.txt文件。
输出与证据
- - 将工件、命令输出和API响应摘要保存至output/alicloud-media-video-translation/目录下。
- 在证据文件中包含关键参数（区域/资源ID/时间范围），以确保可复现性。
参考资料
- - 来源列表：references/sources.md
