Seedance 2.0: Get Asset Name, Status, Type, and URL

Retrieve details and current status for a Seedance 2.0 asset by ID. Poll until status is Active before referencing it in generation tasks.

Use this endpoint to check the status of an uploaded Seedance 2.0 asset and retrieve its details. An asset must have Active status before you can use it in video generation tasks.

Base URL: https://zcbservice.aizfw.cn/kyyReactApiServer

Endpoint: GET /kyyVideo2/asset/{assetId}

---

Path Parameters

assetId · string · required

The asset ID returned from the Upload Asset endpoint.

Example: asset-20260330142158-q75m8

---

Response Fields

code · integer

Response status code. 0 indicates success; any other value indicates failure.

msg · string

Response message. Returns null on success, or an error description on failure.

data · object

The asset detail object, returned on success.

Show data object properties

data.assetId · string

The asset ID, in the format asset-{timestamp}-{random}.

data.name · string

The descriptive name assigned to the asset at upload time.

data.assetType · string

The type of the asset: Image, Video, Audio, or Document.

data.url · string

The original URL that was provided when the asset was uploaded.

data.status · string

The current status of the asset. See Asset Status Values below.

data.createTime · string

The timestamp when the asset was created, in YYYY-MM-DD HH:mm:ss format.

Example: 2026-03-30 14:21:58

---

Asset Status Values

Status	Meaning
Processing	The asset is being uploaded or reviewed. It is not yet ready to use.
Active	The asset has passed review and is ready to use in generation tasks.
Failed	Upload or moderation review failed. This asset cannot be used.

---

Example Request

curl -X GET https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  -H "Authorization: Bearer YOUR_API_KEY"

Success response (Active status):

{
  "code": 0,
  "msg": null,
  "data": {
    "name": "My portrait photo",
    "assetId": "asset-20260330142158-q75m8",
    "status": "Active",
    "assetType": "Image",
    "url": "https://example.com/portrait.jpg",
    "createTime": "2026-03-30 14:21:58"
  }
}

After uploading an asset, poll this endpoint at regular intervals until the status field returns Active. Only then is the asset safe to reference in a video generation task using asset://asset-20260330142158-q75m8.