v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Get Asset

Get a single asset detail by Id. This is a read-only operation and is not billed. Use this endpoint to poll the asynchronous CreateAsset result until Status becomes Active. Failed means preprocessing failed and the asset cannot be used for inference.

post/volc/asset/GetAsset

Request body

Idstring required

Asset ID to query.

Example request

{
  "Id": "asset-20260528140922-d9646"
}

Response

Asset retrieved

Idstring

Namestring

URLstring

Temporary asset file URL. Official examples mark this URL as valid for 12 hours. Do not store it as the long-term asset reference; use asset://<asset_id> in Seedance generation requests.

AssetType'Image' | 'Video' | 'Audio'

GroupIdstring

Status'Processing' | 'Active' | 'Failed'

Asset processing status. Use the asset only when Active; Failed means preprocessing failed and the asset cannot be used.

ProjectNamestring

CreateTimestring

UpdateTimestring

Example response

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "URL": "https://ark-media-asset.tos-cn-beijing.volces.com/...",
  "AssetType": "Video",
  "GroupId": "group-20260528140601-tp9hw",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}