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

# GetAsset

> Get the details and processing status of an asset.

```text theme={null}
POST {BaseUrl}/?Action=GetAsset&Version=2024-01-01
Content-Type: application/json
```

Requests must be signed with HMAC-SHA256. See [Authentication and conventions](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#authentication).

After importing an asset, poll `Status` with this action. Once it is `Active`, the asset can be referenced in generation tasks.

## Request parameters

**Id** `string` *required*

Asset ID.

**ProjectName** `string`

Pass `default` or omit.

## Response parameters

**Result** `object`

**properties**

**Id** `string`

Asset ID.

**GroupId** `string`

ID of the group the asset belongs to.

**Name** `string`

Asset name.

**AssetType** `string`

Asset type: `Image`, `Audio` or `Video`.

**Status** `string`

Processing status: `Processing`, `Active` or `Failed`.

**URL** `string`

Temporary access URL of the asset. It expires and must not be stored as a permanent address.

**Error** `object`

Failure reason with `Code` and `Message`, returned when `Status=Failed`.

**Moderation** `object`

Moderation strategy.

**LastInferenceTime** `string`

Time the asset was last referenced by a generation task. May be absent.

**ProjectName** `string`

Project name.

**CreateTime** `string`

Creation time, ISO 8601 UTC.

**UpdateTime** `string`

Last update time, ISO 8601 UTC.

```json Request body theme={null}
{
  "Id": "asset-20261020080000-abcde"
}
```

```json Active theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Id": "asset-20261020080000-abcde",
    "GroupId": "group-20261020080000-abcde",
    "Name": "tea-reference",
    "AssetType": "Image",
    "Status": "Active",
    "URL": "https://media.example.com/reference.jpg?signature=xxx",
    "Moderation": {
      "Strategy": "Default"
    },
    "ProjectName": "default",
    "CreateTime": "2026-10-20T08:00:00Z",
    "UpdateTime": "2026-10-20T08:00:03Z"
  }
}
```

```json Failed theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Id": "asset-20261020080000-abcde",
    "GroupId": "group-20261020080000-abcde",
    "Name": "tea-reference",
    "AssetType": "Image",
    "Status": "Failed",
    "Error": {
      "Code": "InvalidParameter.DownloadFailed",
      "Message": "Failed to download the file from the URL."
    },
    "ProjectName": "default",
    "CreateTime": "2026-10-20T08:00:00Z",
    "UpdateTime": "2026-10-20T08:00:05Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.