Create Asset

POST /api/volc-user/assets

Create a Volcengine video generation asset (image, video, or audio). After creation, poll Query Asset Detail until the status becomes Active before using it in video generation tasks.

Authentication

User console API requiring logged-in user identity (session Cookie, or Authorization: <access_token>, token obtained via Generate Access Token). This token is different from the sk- keys used for model invocation.

⚠️ Asset creation is an asynchronous process. A successful response only means the request has been submitted to Volcengine for processing, not that the asset is ready. Poll the asset detail endpoint until status = Active.

Request Parameters

Name	Type	Required	Description
groupId	string	Optional	Asset group ID. Uses default group if omitted
url	string	Required	Public asset URL (currently only URL upload is supported, not Base64)
assetType	string	Required	Asset type: Image, Video, Audio
name	string	Optional	Asset name
remark	string	Optional	Platform remark (not passed to Volcengine)

Request Example

{
  "body": {
    "groupId": "group-7f2b8d9c",
    "url": "https://example.com/assets/model-image.png",
    "assetType": "Image",
    "name": "Model Front Image",
    "remark": "External asset ID: ext-10001"
  }
}

Response Fields (200)

Name	Type	Description
success	boolean	Success flag
message	string	Message
data	object	Response data
data.id	string	Asset ID for subsequent queries, updates, deletes, and task references

Response Example

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