Volengine Assets

POST /v1/files/volengine/assets

Create a Volcano Engine material asset.

Create a material asset under the current MaaS user’s Volcano Engine resource group. This endpoint supports Seedance 2.0 workflows that need reusable material asset IDs.

Description

Use this endpoint to register an externally available file URL as a Volcano Engine material asset. The created asset can then be referenced by workflows that require Volcano Engine asset IDs.

Limits

Each account can create up to 10,000 Volcano Engine material assets. Delete assets that are no longer needed before creating more assets after reaching this limit.

Content types

application/json

Headers

Name	Type	Required	Description
`Authorization`	string	Yes	Bearer token in the format `Bearer YOUR_API_KEY`.
`Content-Type`	string	Yes	Must be `application/json`.

Request body parameters

Name	Type	Required	Description
`asset_type`	string	Yes	Type of material asset to create.
`url`	string	Yes	Publicly accessible source URL for the asset.
`name`	string	No	Optional display name for the asset.

Example request

cURL

curl https://api.apifree.ai/v1/files/volengine/assets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_type": "video",
    "url": "https://example.com/assets/source-video.mp4",
    "name": "source-video"
  }'

Response schema

A successful response returns the created asset information. The exact response fields can vary by upstream provider, but typical fields include:

Field	Type	Description
`asset_id`	string	Volcano Engine material asset identifier.
`asset_type`	string	Asset type supplied in the request.
`name`	string	Asset display name when available.
`url`	string	Source URL associated with the asset.
`status`	string	Current asset status when available.

Example response:

{
  "asset_id": "asset_abc123",
  "asset_type": "video",
  "name": "source-video",
  "url": "https://example.com/assets/source-video.mp4",
  "status": "created"
}

Errors

Typical error cases include:

Missing asset_type
Missing url
Invalid JSON payload
Authentication failure
Upstream asset creation failure