Query a custom asset status for Seedance
Seedance Assets
Seedance Asset Info API
Query the upload status and metadata of a Seedance custom asset
GET
Query a custom asset status for Seedance
Overview
Use this endpoint to query the current status of an uploaded asset.Processing: the asset is still being processed and cannot be used yetActive: the asset is ready and can be used in Seedance generation requestsFailed: the asset processing failed and should be uploaded again
Active status can be reused indefinitely and do not currently have an expiration time. Crun may
introduce
a retention period in the future and periodically remove assets; advance notice will be provided when such changes take
effect.
Crun does not store asset IDs on your behalf. Your application is responsible for managing and maintaining asset IDs.
Query Parameters
Asset ID returned by Seedance Asset Upload API. Pass the returned
AssetId value as-is.Request Example
Response Example
Status Enum
| Status | Description | Action |
|---|---|---|
Processing | The asset is still being processed | Continue polling |
Active | The asset is ready to use | Use it in Seedance requests |
Failed | The asset processing failed | Check the error message, correct it, and try again |
Related Resources
Asset Upload
Upload your own image, video, and audio assets
Seedance 2.0 Image to Video
Use active uploaded image assets in image-to-video requests
Seedance 2.0 Reference to Video
Use active uploaded assets in reference-to-video requests
Authorizations
All APIs require authentication via API Key.
Get API Key:
- Visit API Key Management Page to get your API Key
Usage: Add to request header:
x-api-key: YOUR_API_KEY
Note:
- Keep your API Key secure and do not share it with others
- If you suspect your API Key has been compromised, reset it immediately in the management page
Query Parameters
Asset ID returned by Seedance Asset Upload API. Pass the returned AssetId value as-is.
Response
Asset info query successful
Response status code
- 200: Success - Request has been processed successfully
- 401: Unauthorized - Authentication credentials are missing or invalid
- 402: Insufficient Credits - Account does not have enough credits to perform the operation
- 404: Not Found - The requested resource or endpoint does not exist
- 422: Validation Error - The request parameters failed validation checks
- 429: Rate Limited - Request limit has been exceeded for this resource
- 455: Service Unavailable - System is currently undergoing maintenance
- 500: Server Error - An unexpected error occurred while processing the request
- 501: Generation Failed - Content generation task failed
- 505: Feature Disabled - The requested feature is currently disabled
Available options:
200, 401, 402, 404, 422, 429, 455, 500, 501, 505 Response message, error description when failed
Example:
"success"
