Retrieve a single Volcano Engine material asset owned by the current MaaS user. This endpoint supports Seedance 2.0 workflows that need to inspect asset metadata before use.
Description
Use this endpoint to inspect one material asset by asset_id.
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_id | string | Yes | Volcano Engine material asset identifier to retrieve. |
Example request
curl https://api.apifree.ai/v1/files/volengine/assets/get \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asset_id": "asset_abc123"
}'Response schema
A successful response returns 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. |
name | string | Asset display name when available. |
url | string | Source URL associated with the asset when available. |
status | string | Current asset status when available. |
created_at | integer | Unix timestamp for asset creation time when available. |
Example response:
{
"asset_id": "asset_abc123",
"asset_type": "video",
"name": "source-video",
"url": "https://example.com/assets/source-video.mp4",
"status": "created",
"created_at": 1767000000
}Errors
Typical error cases include:
- Missing
asset_id - Authentication failure
- Asset not found
- Asset does not belong to the current user
- Upstream asset retrieval failure