批量查询素材

本接口用于按条件分页查询当前应用下的素材列表，可用于批量查看素材审核进度和审核结果。

请求方法

GET：<ai-api-base-url>/llm/v1/assets

其中，<ai-api-base-url> 为您的 API Key 所属数据中心的域名：

• 北京数据中心：https://ai.rong-api.com
• 北美数据中心：https://ai.us-light-api.com

请求头参数

参数名	类型	是否必填	默认值	说明
Authorization	string	是	-	身份认证令牌，格式为 Bearer <your API key>，需替换为实际 API Key，用于验证用户权限。
X-Request-Id	string	否	-	请求链路追踪 ID。便于问题排查；不传时由服务端按需生成。

Query 参数

以下参数通过 URL Query String 传入。

参数名	类型	是否必填	默认值	说明
asset_type	string	否	-	按素材类型筛选。通常与上传素材时的 type 字段一致，如 image、video、audio。
audit_status	string	否	-	按审核状态筛选。可选值通常包括 Processing、Active、Failed。
limit	integer	否	20	每页返回数量。取值范围：[1, 100]。
offset	integer	否	0	查询偏移量，从 0 开始。

请求示例

cURL

bash

curl --request GET \
  --url '<ai-api-base-url>/llm/v1/assets?asset_type=image&audit_status=Active&limit=20&offset=0' \
  --header 'Authorization: Bearer <token>'

Python

python

import requests

url = "<ai-api-base-url>/llm/v1/assets"
params = {
    "asset_type": "image",
    "audit_status": "Active",
    "limit": 20,
    "offset": 0
}
headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, params=params, headers=headers)
print(response.text)

JavaScript

JavaScript

const params = new URLSearchParams({
  asset_type: 'image',
  audit_status: 'Active',
  limit: 20,
  offset: 0
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
};

fetch(`<ai-api-base-url>/llm/v1/assets?${params}`, options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

返回结果

参数名	类型	是否必返	说明
items	object[]	是	当前查询命中的素材列表，按创建时间倒序返回。
items[].asset_id	string	是	素材唯一 ID。
items[].group_id	string	是	素材所属分组 ID，由融云服务端管理。
items[].volcengine_status	string	是	素材审核状态。可能的值包括 Processing、Active、Failed。
items[].url	string	是	素材记录对应的访问地址。

返回结果示例

JSON

{
  "items": [
    {
      "asset_id": "asset-20260416160625-h123p",
      "group_id": "group-20260416-demo",
      "volcengine_status": "Active",
      "url": "https://example.com/assets/2026/04/16/portrait.png"
    },
    {
      "asset_id": "asset-20260416160211-a82kd",
      "group_id": "group-20260416-demo",
      "volcengine_status": "Processing",
      "url": "https://example.com/assets/2026/04/16/portrait-2.png"
    }
  ]
}

说明

• 该接口仅返回当前 API Key 所属应用下的素材记录。
• 若您只关心单个素材的审核结果，建议直接使用查询素材详情接口。