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

> 查询素材详情与处理状态。

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

请求需使用 HMAC-SHA256 签名，见[鉴权与通用约定](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#鉴权)。

导入素材后，用本接口轮询 `Status`，变为 `Active` 后即可在生成任务中引用。

## 请求参数

**Id** `string` *required*

素材 ID。

**ProjectName** `string`

可传 `default` 或不传。

## 响应参数

**Result** `object`

**属性**

**Id** `string`

素材 ID。

**GroupId** `string`

所属素材组 ID。

**Name** `string`

素材名称。

**AssetType** `string`

素材类型：`Image`、`Audio` 或 `Video`。

**Status** `string`

处理状态：`Processing`、`Active` 或 `Failed`。

**URL** `string`

素材的临时访问地址，有时效，不能作为永久地址保存。

**Error** `object`

处理失败原因，`Status=Failed` 时返回，包含 `Code` 和 `Message`。

**Moderation** `object`

审核策略。

**LastInferenceTime** `string`

最近一次被生成任务引用的时间，可能不返回。

**ProjectName** `string`

项目名称。

**CreateTime** `string`

创建时间，ISO 8601 UTC。

**UpdateTime** `string`

更新时间，ISO 8601 UTC。

```json 请求体 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.