跳到主要内容

查询素材详情

本接口用于根据素材 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

请求头参数

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

路径参数

参数名类型是否必填说明
asset_idstring素材 ID,例如 asset-20260416160625-h123p

请求示例

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

返回结果

参数名类型是否必返说明
asset_idstring素材唯一 ID。
group_idstring素材所属分组 ID,由融云服务端管理。
volcengine_statusstring素材审核状态。可能的值包括 ProcessingActiveFailed
urlstring素材记录对应的访问地址。

返回结果示例

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_statusActive 时,可在创建视频生成任务接口中通过 asset://{asset_id} 引用该素材。
  • 如果素材仍处于 Processing,可继续轮询本接口或使用批量查询素材接口查看最新状态。