Skip to main content
GET
/
api
/
v1
/
client
/
job
/
asset-info
Query a custom asset status for Seedance
curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/asset-info \
  --header 'x-api-key: <api-key>'
{
  "code": 200,
  "message": "success",
  "data": {
    "AssetId": "asset-20260420153000-ab12c",
    "Name": "fashion-model-front",
    "AssetType": "Image",
    "Status": "Active",
    "CreateTime": "2026-04-21T02:41:43Z",
    "UpdateTime": "2026-04-21T02:41:43Z"
  }
}

Overview

Use this endpoint to query the current status of an uploaded asset.
  • Processing: the asset is still being processed and cannot be used yet
  • Active: the asset is ready and can be used in Seedance generation requests
  • Failed: the asset processing failed and should be uploaded again
Assets with an 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
string
required
Asset ID returned by Seedance Asset Upload API. Pass the returned AssetId value as-is.

Request Example

curl -X GET "https://api.crun.ai/api/v1/client/job/asset-info?asset_id=asset-20260420153000-ab12c" \
-H "X-API-KEY: YOUR_API_KEY"

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "AssetId": "asset-20260420153000-ab12c",
    "Name": "fashion-model-front",
    "AssetType": "Image",
    "Status": "Active",
    "CreateTime": 1768900378,
    "UpdateTime": 1768900415
  }
}

Status Enum

StatusDescriptionAction
ProcessingThe asset is still being processedContinue polling
ActiveThe asset is ready to useUse it in Seedance requests
FailedThe asset processing failedCheck the error message, correct it, and try again

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

x-api-key
string
header
required

All APIs require authentication via API Key.

Get API Key:

  1. 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
string
required

Asset ID returned by Seedance Asset Upload API. Pass the returned AssetId value as-is.

Response

Asset info query successful

code
enum<integer>

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
message
string

Response message, error description when failed

Example:

"success"

data
object