EasyRouterEasyRouter
使用指南API 文档接入 Agent 工具
管理接口真人认证与素材管理

上传人像素材

POST
/api/resource-channel/byteplus/visual-validate/assets

Authorization

BearerAuth

AuthorizationBearer <token>

API Key (sk-xxxxxx)

In: header

Request Body

application/json

group_id*string

关联的人像素材组 Group ID，可通过「获取真人认证结果并查询 GroupId」接口返回的 group_id 字段获取

⚠️ 重要提示 group_id 来源 group_id 由「获取真人认证结果并查询 GroupId」接口返回，该值已在真人认证完成后自动生成，请务必通过该接口获取，不可自行构造或使用其他来源的值。

url*string

素材的公网可访问 URL，例如 https://upload.wikimedia.org/wikipedia/commons/8/83/Tupi_languages.png

name?string

素材名称，可用于模糊搜索

asset_type*string

资产类型，支持 Image / Video / Audio

Response Body

application/json

curl -X POST "https://easyrouter.io/api/resource-channel/byteplus/visual-validate/assets" \  -H "Content-Type: application/json" \  -d '{    "group_id": "string",    "url": "string",    "asset_type": "string"  }'
{
  "success": true,
  "message": "",
  "data": {
    "id": "asset-20260521164235-zggcb",
    "group_id": "group-20260521163909-kbdhw",
    "name": "test123",
    "url": "https://upload.wikimedia.org/wikipedia/commons/8/83/Tupi_languages.png",
    "asset_type": "Image",
    "status": "Processing",
    "create_time": "2026-05-21T08:42:35.454099721Z"
  },
  "warning": "CreateAsset 为异步接口，上传成功不代表资源已可用于推理，请继续调用查询接口直到 status=Active。"
}