Vidu 主体库 API 文档

创建/查询/更新 Vidu 主体，供 reference-to-video 通过 subjects[].server_id 或 @name 引用。

服务商支持

仅 Vidu 官方渠道。

---

创建主体

网络协议	请求地址	请求方法
https	/videos/vidu/subjects	POST

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Bearer	aiping 平台鉴权

参数名	类型	必填	说明
name	string	是	主体名称
images	array	否	最多 3 张
videos	array	否	视频主体（q2-pro）
voice_id	string	否	音色

响应 id 即后续 server_id。

创建主体成功一次消费 5 credits。

积分与人民币换算比例为：1 积分 = 0.03125 元。

请求示例

{
  "name": "hero_subject_demo",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "voice_id": "",
  "extra_body": {
    "provider": { "only": ["Vidu"] }
  }
}

返回结构示例

{
  "id": "elem_ap_replace_with_subject_id",
  "name": "hero_subject_demo",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "voice_id": "",
  "aiping_id": "string"
}

---

查询主体列表

| https | /videos/vidu/subjects | GET |

Query：ownership、subject_ids、count、next_page_token 等（详见 Vidu 官方文档）。

查询示例

GET /videos/vidu/subjects?ownership=private&count=20
GET /videos/vidu/subjects?ownership=private&subject_ids=elem_ap_replace_with_subject_id

---

更新主体

| https | /videos/vidu/subjects/{subject_id} | PUT |

请求示例

{
  "name": "hero_subject_demo_updated",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "extra_body": {
    "provider": { "only": ["Vidu"] }
  }
}

---

注意事项

1. 主体接口仅 Vidu 官方。
2. 主体库引用见 reference-to-video.md：带 subjects[].server_id 时 proxy 强制走 Vidu 官方。