任务：视频配音

查看示例：（示例有效期30天-如无法查看说明已过期）

查看原视频

查看配音后视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

input

object

必需

video_id

string

视频ID（注意：不是任务ID）

必需

● 仅支持使用30天内生成的5秒视频或10秒视频

如果原视频是10秒，则扣费x2倍

mode

enum<string>

视频模式

必需

○ text2video：文本生成视频模式，此模式时input·text、input·voice_id、input·voice_language参数为必填；音频生成视频模式相关参数无效
○ audio2video：音频生成视频模式，此模式时input·audio_type参数为必填，文本生成视频模式相关参数无效

枚举值:

text2videoaudio2video

示例值:

text2video

text

string

口型文字

可选

● input·mode参数值为text2video时，当前参数必填
● 文本内容最大长度120，内容过长会返回错误码等信息
● 系统会校验文本内容，如有问题会返回错误码等信息

voice_id

string

音色ID

可选

● input·mode参数值为text2video时，当前参数必填
● 系统提供多种音色可供选择，具体音色效果、音色ID、音色语种对应关系点此查看；音色试听不支持自定义文案
● 音色试听文件命名规范：音色名称#音色ID#音色语种

voice_language

enum<string>

音色语种

可选

● input·mode参数值为text2video时，当前参数必填
● 音色语种与音色ID对应，详见上文

枚举值:

zhen

默认值:

示例值:

voice_speed

number

语速

可选

● 有效范围：0.8~2.0，精确至小数点后1位，超出部分将自动四舍五入
● input·mode参数值为text2video时，当前参数必填

>= 0.8< 2

默认值:

audio_type

string

音频文件类型

可选

● 枚举值：file，url
● file：上传文件模式，此时input·audio_file参数必填
● url：提供下载链接模式，此时input·audio_url参数必填
● input·mode参数值为audio2video时，当前参数必填

audio_file

string

音频文件路径

可选

● input·audio_type参数值为file时，当前参数必填
● 音频文件支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB，Base64编码，格式不匹配或文件过大会返回错误码等信息
● 系统会校验音频内容，如有问题会返回错误码等信息

audio_url

string

音频文件地址

可选

● input·audio_type参数值为url时，当前参数必填
● 音频文件支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息
● 系统会校验音频内容，如有问题会返回错误码等信息

callback_url

string

通知地址

可选

本次任务结果回调通知地址，详见 CallBack协议

示例

{
  "input": {
    "video_id": "c01bbafe-712e-4a00-8265-fe7b4e9b17bf",
    "mode": "text2video",
    "text": "天空一声巨响，老娘闪亮登场",
    "voice_id": "chat1_female_new-3",
    "voice_language": "zh"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

task_id

string

必需

action

string

必需

status

string

必需

fail_reason

string

必需

submit_time

integer

必需

start_time

integer

必需

finish_time

integer

必需

progress

string

必需

data

object

必需

created_at

integer

必需

updated_at

integer

必需

task_result

object

必需

task_status

string

必需

task_status_msg

string

必需

request_id

string

必需

示例

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "ClpejWduJGYAAAAAAUvWMw",
  "data": {
    "task_id": "ClpejWduJGYAAAAAAUvWMw",
    "task_status": "submitted",
    "created_at": 1736058335197,
    "updated_at": 1736058335197
  }
}