> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xingchaoyiqing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField path="assetId" type="string" required>
  The asset ID returned from the [Upload Asset](/api-reference/assets/seedance2-asset-upload) endpoint.

  Example: `asset-20260330142158-q75m8`
</ParamField>

***

## Response Fields

<ResponseField name="code" type="integer">
  Response status code. `0` indicates success; any other value indicates failure.
</ResponseField>

<ResponseField name="msg" type="string">
  Response message. Returns `null` on success, or an error description on failure.
</ResponseField>

<ResponseField name="data" type="object">
  The asset detail object, returned on success.

  <Expandable title="data object properties">
    <ResponseField name="data.assetId" type="string">
      The asset ID, in the format `asset-{timestamp}-{random}`.
    </ResponseField>

    <ResponseField name="data.name" type="string">
      The descriptive name assigned to the asset at upload time.
    </ResponseField>

    <ResponseField name="data.assetType" type="string">
      The type of the asset: `Image`, `Video`, `Audio`, or `Document`.
    </ResponseField>

    <ResponseField name="data.url" type="string">
      The original URL that was provided when the asset was uploaded.
    </ResponseField>

    <ResponseField name="data.status" type="string">
      The current status of the asset. See [Asset Status Values](#asset-status-values) below.
    </ResponseField>

    <ResponseField name="data.createTime" type="string">
      The timestamp when the asset was created, in `YYYY-MM-DD HH:mm:ss` format.

      Example: `2026-03-30 14:21:58`
    </ResponseField>
  </Expandable>
</ResponseField>

***

## 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

```bash theme={null}
curl -X GET https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Success response (Active status):**

```json theme={null}
{
  "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"
  }
}
```

<Tip>
  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`.
</Tip>