跳转到主要内容
POST
创建视频翻译任务

回调通知

视频翻译任务处理完成后,服务将向发起请求中提供的 callback_url 发送一个 POST 请求。

结构

code
integer
响应状态码。0 表示回调发送成功。
msg
string
响应消息,通常为 “ok”。
task_type
string
任务类型。枚举值:video_translate
data
object
包含翻译结果的数据载体。

回调示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建视频翻译任务。

target_languages
string[]
必填

目标语言代码列表

示例:
video_url
string<uri>
必填

待翻译的视频文件 URL。

示例:

"https://example.com/test-video.mp4"

speaker_num
integer
默认值:0

视频中的说话人数量。

必填范围: x >= 0
示例:

1

translate_audio_only
boolean
默认值:false

仅翻译音频,忽略面部,只翻译视频中的语音轨道。

示例:

true

enable_dynamic_duration
boolean
默认值:true

拉伸或缩短视频片段,以增强不同语速语言之间的对话流畅性和翻译质量。

示例:

true

enable_caption
boolean
默认值:false

是否生成字幕。

示例:

false

name
string

视频名称,字符长度小于 100。翻译后的视频名称格式为:目标语言 + "-" + name,例如 English_myTestVideo。如果未传值或传空值,翻译后的视频名称格式为:目标语言 + "-" + videoTranslate + "-" + 秒级时间戳,例如:English-videoTranslation-2020120123001。

示例:

"English-videoTranslation-2020120123001"

callback_url
string<uri>

任务完成回调通知 URL。

示例:

"https://your-server.com/callback"

响应

任务创建成功

视频翻译任务创建响应

code
integer
必填

状态码(0 表示成功)

示例:

0

msg
string
必填

响应消息

示例:

"ok"

data
object[]
必填

包含生成的任务 ID 和语言的数据