上传素材并发起审核

本接口用于上传素材并发起审核。对于涉及人物肖像的真人图片素材，建议先调用本接口完成审核，再在视频生成任务中引用对应的素材 ID。

请求方法

POST：<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，用于验证用户权限。
Content-Type	string	是	application/json	请求体格式。固定传 application/json。
X-Request-Id	string	否	-	请求链路追踪 ID。便于问题排查；不传时由服务端按需生成。

正文参数

参数名	类型	是否必填	默认值	说明
url	string	是	-	待上传素材的公网可访问 URL。建议使用稳定、可直接下载的源地址，并确保源文件满足上传素材文件要求。
type	string	是	-	素材类型。常见值为 image、video、audio。涉及真人视频审核场景时，通常传 image。
name	string	否	-	素材展示名称，便于后续在素材列表中识别。

提示

素材分组信息由融云服务端统一管理，客户端无需传入 group_id。如果请求中包含该字段，服务端会按当前租户配置自动处理。

请求示例

cURL

bash

curl --request POST \
  --url '<ai-api-base-url>/llm/v1/assets' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "https://example.com/portrait.png",
    "type": "image",
    "name": "主播正面人像"
  }'

Python

python

import requests

url = "<ai-api-base-url>/llm/v1/assets"
payload = {
    "url": "https://example.com/portrait.png",
    "type": "image",
    "name": "主播正面人像"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

JavaScript

JavaScript

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com/portrait.png',
    type: 'image',
    name: '主播正面人像'
  })
};

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

返回结果

参数名	类型	是否必返	说明
asset_id	string	是	素材唯一 ID。审核通过后，可在视频生成请求中按 asset://{asset_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": "Processing",
  "url": "https://example.com/assets/2026/04/16/portrait.png"
}

说明

• 上传成功只表示素材已受理，不代表已审核通过。
• 对于需要审核的人像素材，请继续调用查询接口轮询 volcengine_status，直到状态变为 Active。
• 当前接口返回的是素材业务对象本身，不再额外包裹在 data 字段中。