⌘K

Vidu Get Subjects

vidu_get_subjects

Vidu Get Subjects 用于查询主体列表, 支持按归属、主体 ID 或数量过滤, 并支持分页查询.

认证

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, 最大 100

type string

资源类型, 此接口返回 text