`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAsset&Version=2024-01-01`
查询素材资产状态，确认素材是否已完成预处理并可用于推理。

```mixin-react
return (<Tabs>
<Tabs.TabPane title="快速入口" key="k6xoCAAzLe"><RenderMd content={`<span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57d0bca8e0d122ab1191b40101b5df75.png =20x) </span> [调用教程](https://www.volcengine.com/docs/82379/2333565) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png =20x) </span> [接口列表](https://www.volcengine.com/docs/82379/2318269) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png =20x) </span> [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
`}></RenderMd></Tabs.TabPane>
<Tabs.TabPane title="鉴权说明" key="NcZDHXiFXA"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
`}></RenderMd></Tabs.TabPane></Tabs>);
```


---


<span id="request-params"></span>
## 请求参数
<span id="request-body"></span>
### 请求体

---


**Id** `string` %%require%%
Asset（素材资产）的 Id。

---


**ProjectName** `string`
需要查询的 Asset（素材资产）所属的项目名称，默认值为 `default`。
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
<span id="response-params"></span>
## 响应参数

---


**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`
资源所属的项目名称。

---


<span id=".6K-35rGC56S65L6L"></span>
## 请求示例
```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"
}
```

<span id=".5ZON5bqU56S65L6L"></span>
## 响应示例
```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"
  }
}
```



