创建素材

POST /api/volc-user/assets

创建火山视频生成素材（图片、视频或音频）。素材创建后需轮询 查询素材详情 直到状态为 Active 后方可用于视频生成任务。

鉴权说明

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

⚠️ 素材创建是异步过程，接口返回成功仅表示已提交火山处理，不代表素材已可用。请轮询素材详情直到 status = Active。

请求参数

参数名	类型	必选	说明
groupId	string	可选	素材组 ID。不传时使用默认素材组
url	string	必选	素材公网 URL（当前仅支持 URL 上传，不支持 Base64）
assetType	string	必选	素材类型：Image、Video、Audio
name	string	可选	素材名称
remark	string	可选	平台侧备注（不透传给火山）

请求示例

{
  "body": {
    "groupId": "group-7f2b8d9c",
    "url": "https://example.com/assets/model-image.png",
    "assetType": "Image",
    "name": "模特正面图",
    "remark": "第三方业务素材 ID: ext-10001"
  }
}

响应字段（200）

字段名	类型	说明
success	boolean	是否成功
message	string	提示信息
data	object	响应数据
data.id	string	素材 ID，用于后续查询、更新、删除及任务引用

响应示例

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