Skip to main content
POST
Get Asset

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
Id
string
required

Asset ID to query.

Example:

"asset-20260528140922-d9646"

Response

Asset retrieved

Id
string
Example:

"asset-20260528140922-d9646"

Name
string
Example:

"character-reference"

URL
string

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.

Example:

"https://ark-media-asset.tos-cn-beijing.volces.com/..."

AssetType
enum<string>
Available options:
Image,
Video,
Audio
Example:

"Video"

GroupId
string
Example:

"group-20260528140601-tp9hw"

Status
enum<string>

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

Available options:
Processing,
Active,
Failed
Example:

"Active"

ProjectName
string
Example:

"default"

CreateTime
string
Example:

"2026-05-28T06:09:22Z"

UpdateTime
string
Example:

"2026-05-28T06:09:31Z"