创建真人素材

POST /api/volc-user/assets

向已完成真人认证的素材组添加素材。先 创建认证会话，待认证成功取得 groupId 后再上传。素材提交后仍需等待审核处理。

鉴权说明

用户控制台接口，使用登录会话 Cookie，或请求头 Authorization: <access_token>。访问令牌由 生成访问令牌 获取，与模型调用使用的 sk- 密钥不同。

请求参数

参数名	类型	必选	说明
groupId	string	必选	当前用户认证所得的平台素材组 ID；真人素材必须指定
groupType	string	可选	建议显式传 LivenessFace；省略时按指定素材组判定类型
url	string	必选	上游可访问的素材公网 URL；真人素材不支持 multipart 文件或 Base64 上传
assetType	string	必选	素材类型：Image、Video、Audio；最终可用性由上游审核和所用视频模型能力决定
name	string	可选	素材名称
remark	string	可选	平台侧备注，不传给上游

请求示例

POST /api/volc-user/assets
Authorization: <access_token>
Content-Type: application/json

{
  "groupId": "group-example",
  "groupType": "LivenessFace",
  "url": "https://example.com/portrait.jpg",
  "assetType": "Image",
  "name": "本人正面照",
  "remark": "external-asset-001"
}

响应字段（200）

字段名	类型	说明
success	boolean	业务是否成功；HTTP 200 仍需检查此字段
message	string	提示信息，成功时为空字符串
data	object	成功时的响应数据
data.id	string	本次操作的平台资源 ID

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-example"
  }
}

JSON 参数直接放在请求体顶层，无需 body 包装。成功只表示素材已创建，请 查询真人素材详情，等待 status=Active 且 assetStatus=1 后再用于视频生成。素材内容必须满足对应真人认证与上游审核要求。