非实时交互数字人-视频文件版

Vidu-S1 数字人

面向业务方的对外接口文档。离线数字人基于输入角色图 + 音频 + 动作时间轴，生成说话视频。

Base URL：国内环境 https://api.vidu.cn，海外环境 https://api.vidu.com。接口完整路径 = Base URL + 下文接口路径。

POST https://api.vidu.cn/ent/v2/avatar-video/generations

创建离线数字人视频生成任务，返回任务 ID 与状态，可通过「查询任务」接口轮询结果。

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	类型	必填	说明
model	string	否	模型，可选值：vidu-s1，默认值：vidu-s1
image	string	是	角色图片，支持 URL / base64(含 MIME) / ssuploadid
audio	string	条件必填	语音音频，支持 URL / base64 / ssuploadid；与 text 至少传一个（双传 audio 优先）
text	string	条件必填	说话文本，与 audio 至少传一个（双传 audio 优先）；UTF-8，≤10000 字符；传 text 时系统将其合成为语音
voice	string	否	音色，不传时使用默认音色；仅 text 模式（未传 audio）生效
timeline	string	否	动作时间轴，序列化后的 ActionContent JSON（见下方格式）；不传时由系统基于音频自动生成
resolution	string	否	分辨率，可选值: 540p, 720p，默认值：540p
callback_url	string	否	任务完成回调地址，复用现有回调机制
payload	string	否	透传参数，原样返回
moderation	enum	否	审核策略，复用现有 Moderation 枚举
watermark	bool	否	是否加水印，复用现有水印逻辑
wm_position	enum	否	水印位置，复用现有 WatermarkParam
wm_url	string	否	自定义水印图片 URL
meta_data	string	否	透传元数据

timeline 参数为序列化后的 JSON 字符串，结构如下：

{
  "actions": [
    { "text": "比个心", "time_range": [2, 10] }
  ]
}

text：动作描述文本
time_range：动作起止时间（秒），必须包含 2 个 uint32，依次为开始、结束时间

字段	类型	说明
task_id	int64	任务 ID，用于查询任务状态
state	enum	任务状态，复用现有 State 枚举
model	string	模型标识
resolution	string	分辨率
credits	int32	预计消耗积分
payload	string	透传参数原样返回
created_at	timestamp	任务创建时间

{
  "task_id": 123456789,
  "state": "created",
  "model": "vidu-s1",
  "resolution": "540p",
  "credits": 30,
  "created_at": "2026-08-03T03:00:00Z"
}

GET https://api.vidu.cn/ent/v2/tasks/{task_id}/creations

按任务 ID 返回状态、积分消耗、时长、错误信息与生成物列表。

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

参数名称	类型	必填	参数描述
task_id	Int64	是	创建任务时返回的任务 ID

voice 支持 MiniMax 系统音色（voice_id），常用音色如下；完整多语言音色列表见新音色列表

音色 ID	音色名称
female-shaonv	少女（默认）
male-qn-qingse	青涩青年
male-qn-jingying	精英青年
male-qn-badao	霸道青年
male-qn-daxuesheng	青年大学生
female-yujie	御姐
female-chengshu	成熟女性
female-tianmei	甜美女性
female-shaonv-jingpin	少女-beta
male-qn-qingse-jingpin	青涩青年-beta
male-qn-jingying-jingpin	精英青年-beta
male-qn-badao-jingpin	霸道青年-beta
male-qn-daxuesheng-jingpin	青年大学生-beta
female-yujie-jingpin	御姐-beta
female-chengshu-jingpin	成熟女性-beta
female-tianmei-jingpin	甜美女性-beta
presenter_male	男性主持人
presenter_female	女性主持人
audiobook_male_1 / audiobook_male_2	男性有声书 1 / 2
audiobook_female_1 / audiobook_female_2	女性有声书 1 / 2
clever_boy / cute_boy / lovely_girl	聪明男童 / 可爱男童 / 萌萌女童
qiaopi_mengmei / wumei_yujie	俏皮萌妹 / 妩媚御姐

中文（粤语）音色：Cantonese_ProfessionalHost（F）、Cantonese_GentleLady、Cantonese_CuteGirl 等；英文、日文、韩文、西班牙文、葡萄牙文等其他语种音色（English_* / Japanese_* / Korean_* / Spanish_* / Portuguese_*）详见上方官方链接。

项目	说明
计费单位	视频时长（秒），按输入音频实际时长向上取整
单价	1秒1积分

搜索文档

搜索文档