查询素材详情

本接口用于根据素材 ID 查询当前应用下单个素材的审核状态和素材信息。

请求方法

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

其中，<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。便于问题排查；不传时由服务端按需生成。

路径参数

参数名	类型	是否必填	说明
asset_id	string	是	素材 ID，例如 asset-20260416160625-h123p。

请求示例

cURL

bash

curl --request GET \
  --url '<ai-api-base-url>/llm/v1/assets/asset-20260416160625-h123p' \
  --header 'Authorization: Bearer <token>'

Python

python

import requests

asset_id = "asset-20260416160625-h123p"
headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(
    f"<ai-api-base-url>/llm/v1/assets/{asset_id}",
    headers=headers
)
print(response.text)

JavaScript

JavaScript

const assetId = 'asset-20260416160625-h123p';

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

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

返回结果

参数名	类型	是否必返	说明
asset_id	string	是	素材唯一 ID。
group_id	string	是	素材所属分组 ID，由融云服务端管理。
volcengine_status	string	是	素材审核状态。可能的值包括 Processing、Active、Failed。
url	string	是	素材记录对应的访问地址。

返回结果示例

JSON

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

错误说明

HTTP 状态码	说明
404	素材不存在，或该素材不属于当前 API Key 所属应用。

说明

• 当 volcengine_status 为 Active 时，可在创建视频生成任务接口中通过 asset://{asset_id} 引用该素材。
• 如果素材仍处于 Processing，可继续轮询本接口或使用批量查询素材接口查看最新状态。