⌘K

Vidu Create Subjects

vidu_create_subjects

Vidu Create Subjects 用于创建可复用主体, 支持上传主体图片与视频参考, 并为主体配置音色.

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

: vidu_create_subjects


name string 必填

主体名称(建议唯一)


images array[string]

主体图片, 至少上传 1 张主体图片

注1:支持传入图片 Base64 编码或图片 URL(确保可访问)
注2:最多支持输入 3 张图
注3:图片支持 png、jpeg、jpg、webp 格式
注4:图片比例需要小于 1:4 或者 4:1
注5:图片大小不超过 50 MB
注6:请注意, base64 decode 之后的字节长度需要小于 20M, 且编码必须包含适当的内容类型字符串, 例如:

data:image/png;base64,{base64_encode}

videos array[string]

视频参考, 支持上传 1 个主体视频

注1:仅参考生 viduq2-pro 模型支持使用视频主体
注2:最多支持上传 1 个 5 秒的视频
注3:视频支持 mp4、avi、mov 格式
注4:视频像素不能小于 128*128, 且比例需要小于 1:4 或者 4:1, 且大小不超过 100M
注5:请注意, base64 decode 之后的字节长度需要小于 20M, 且编码必须包含适当的内容类型字符串, 例如:

data:video/mp4;base64,{base64_encode}

voice_id string

主体音色 ID, 该信息仅在创建音视频直出任务时使用

注1:不传音色 ID 生成音视频直出任务时, 系统会自动推荐音色
注2:q2-pro 不支持使用音色 ID


轮询

由于结果生成需要时间,您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

output array

生成结果. 仅在状态为 completed 时出现.

content array

生成内容列表

text string

主体信息 JSON 字符串, 包含以下参数:
id:本次生成的主体 ID(server_id)
name:本次生成自定义的主体名称
images:本次生成主体的图像参数
videos:本次生成主体的视频参数
voice_id:本次生成主体绑定的音色 ID
style:本次生成的主体风格信息
description:本次生成的主体描述
credits:本次调用使用的积分数

type string

资源类型, 此接口返回 text