`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAsset&Version=2024-01-01`
查询素材资产状态，确认素材是否已完成预处理并可用于推理。
```mixin-react
return (
 [调用教程](https://www.volcengine.com/docs/82379/2333565)  [接口列表](https://www.volcengine.com/docs/82379/2318269)  [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
`}>
);
```
---
## 请求参数
### 请求体
---
**Id** `string` %%require%%
Asset（素材资产）的 Id。
---
**ProjectName** `string`
需要查询的 Asset（素材资产）所属的项目名称，默认值为 `default`。
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
## 响应参数
---
**Id** `string`
Asset（素材资产）的 Id。
---
**Name** `string`
Asset（素材资产）的名称，上限为 64 个字符。
---
**URL** `string`
Asset（素材资产）的访问地址。有效期为 12 小时，请及时保存。
---
**AssetType** `string`
Asset（素材资产）的类型。可选值：
* `Image`
* `Video`
* `Audio`
---
**GroupId** `string`
Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。
---
**Status** `string`
素材资产状态。可选值：
* `Active`：已处理完毕，可以使用
* `Processing`：正在预处理，无法使用
* `Failed`：处理失败
---
**Error** `object`
错误信息。
属性
---
Error.**Code** `string`
错误码。
---
Error.**Message** `string`
错误信息。
---
**CreateTime** `string`
创建时间。
---
**UpdateTime** `string`
更新时间。
---
**ProjectName** `string`
资源所属的项目名称。
---
## 请求示例
```text
POST /?Action=GetAsset&Version=2024-01-01 HTTP/1.1
Host: ark.cn-beijing.volcengineapi.com
Content-Type: application/json
X-Date: 20260328T000000Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=AKLTYz******/20260328/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=47a7d934******e41085f
{
"Id": "Asset-2026**********-*****",
"ProjectName": "default"
}
```
## 响应示例
```json
{
"ResponseMetadata": {
"RequestId": "20260328000000000000000000000000",
"Action": "GetAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Id": "Asset-2026**********-*****",
"Name": "test",
"URL": "https://example.com/asset-url",
"AssetType": "Image",
"GroupId": "group-2026**********-*****",
"Status": "Active",
"Error": {
"Code": "",
"Message": ""
},
"CreateTime": "2026-03-28T00:00:00Z",
"UpdateTime": "2026-03-28T00:00:00Z",
"ProjectName": "default"
}
}
```