认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
值: vidu_get_subjects
ownership string
主体归属
可选值:system(官方主体)、private(个人主体)
默认值:private
subject_ids array[string]
指定主体 ID 查询, 可以查询多个
count integer
查询数量
默认值:20
最大值:100
next_page_token string
分页 token. 第一次请求可不传, 若存在多页结果则响应中会返回 next_page_token, 下一页请求时传入该值
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
output array
生成结果. 仅在状态为 completed 时出现.
content
array生成内容列表
text
string主体列表信息 JSON 字符串, 包含以下参数:
subjects:本次查询的主体信息列表
subjects[].id:主体 ID(server_id)
subjects[].name:主体名称
subjects[].images:主体的图像参数
subjects[].videos:主体的视频参数
subjects[].voice_id:主体绑定的音色 ID
subjects[].style:主体的风格信息(官方主体不展示该信息)
subjects[].description:主体的详细描述信息(官方主体不展示该信息)
next_page_token:下一页 token, 无更多数据时为空
count:本次查询数量, 默认 20, 最大 100type
string资源类型, 此接口返回
text