认证
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