通过本接口,您可以提交视频翻译任务。当前已支持字幕级翻译(将视频中出现的字幕翻译为指定语言)、声音(口播)级翻译(将音频中的口播内容翻译为指定语言)与面容级翻译(口型适配)。
接口说明
-
在此接口中,所有媒资的 OSS URL 中的区域(region)必须与调用 OpenAPI 服务地址中的区域(region)保持一致。
-
该接口支持每秒 30 次请求(QPS 30)。提交任务多时,会自动进入队列并动态扩容处理,无并发执行数量限制。
-
该接口为异步接口,提交任务后返回任务 ID(此时任务尚未完成,任务将进入后台排队异步执行),最终结果将通过回调通知,也可通过 获取智能任务结果 主动查询任务状态。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:SubmitVideoTranslationJob |
none |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InputConfig |
string |
否 |
视频翻译任务的输入参数
|
{"Type":"Video","Video":"1628ae20c36******8f6f7c77a6302"} |
| EditingConfig |
string |
否 |
视频翻译任务的配置参数,符合 JSON 格式。 |
{"SourceLanguage":"zh","TargetLanguage":"en","DetextArea":"Auto"} |
| OutputConfig |
string |
否 |
视频翻译任务的输出参数,支持以视频类型、字幕文件类型输出。 |
{"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4"} |
| Title |
string |
否 |
任务标题。 |
测试标题 |
| Description |
string |
否 |
任务描述。 |
测试描述 |
| UserData |
string |
否 |
自定义信息,Json 格式,长度限制为 512 字节。 |
{"NotifyAddress":"http://xx.xx.xxx"} |
| ClientToken |
string |
否 |
保证请求幂等性。 |
测试 ClientToken |
| SignatureMehtod |
string |
否 |
自动补全,无需写入 |
自动补全,无需写入 |
| SignatureType |
string |
否 |
自动补全,无需写入 |
自动补全,无需写入 |
详细的参数说明与示例,请参考:视频翻译参数介绍与示例
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
******3B-0E1A-586A-AC29-742247****** |
| Success |
boolean |
调用是否成功。 取值:
|
true |
| Data |
object |
响应数据 |
|
| JobId |
string |
视频翻译任务 ID |
****d718e2ff4f018ccf419a7b71**** |
示例
正常返回示例
JSON格式
{
"RequestId": "******3B-0E1A-586A-AC29-742247******",
"Success": true,
"Data": {
"JobId": "****d718e2ff4f018ccf419a7b71****"
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。