List non-deleted Volcano Engine material assets owned by the current MaaS user. This endpoint supports Seedance 2.0 workflows by showing available reusable material assets.
Description
Use this endpoint to page through available Volcano Engine material assets stored for the current user.
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 |
|---|---|---|---|
page | integer | No | Page number to retrieve. |
page_size | integer | No | Number of assets to return per page. |
Example request
curl https://api.apifree.ai/v1/files/volengine/assets/list \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"page": 1,
"page_size": 20
}'Response schema
A successful response returns a page of assets. The exact response fields can vary by upstream provider, but typical fields include:
| Field | Type | Description |
|---|---|---|
data | array | Asset records for the current page. |
page | integer | Current page number when available. |
page_size | integer | Number of assets requested per page when available. |
total | integer | Total matching assets when available. |
Each asset record typically includes:
| Field | Type | Description |
|---|---|---|
asset_id | string | Volcano Engine material asset identifier. |
asset_type | string | Asset type. |
name | string | Asset display name when available. |
url | string | Source URL associated with the asset when available. |
status | string | Current asset status when available. |
Example response:
{
"data": [
{
"asset_id": "asset_abc123",
"asset_type": "video",
"name": "source-video",
"url": "https://example.com/assets/source-video.mp4",
"status": "created"
}
],
"page": 1,
"page_size": 20,
"total": 1
}Errors
Typical error cases include:
- Invalid pagination values
- Invalid JSON payload
- Authentication failure
- Upstream asset list failure