创建素材分组

API 配置

保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。

Base: api.xrtoken.net

创建一个新的素材分组（AssetGroup），用于组织管理素材文件。

每个分组归属于当前认证用户，不同用户之间的分组相互隔离。同一用户下的所有 API Key 共享素材分组。

Authorization

BearerAuth

AuthorizationBearer <token>

API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

分组名称

description?string

分组描述（可选）

external_user_id?string

第三方 SaaS 终端用户标识符（opaque 字符串，≤128 字符，可选）。设了之后, 该 group 绑定到 (api_user, external_user_id)，同 API key 下的其他 end-user 看不到。不传 = 老行为（单租户共享）。

Lengthlength <= 128

curl -X post "https://api.xrtoken.net/v1/asset-groups" \  -H "Content-Type: application/json" \  -d '{    "name": "视频素材"  }'

{
  "Id": "string",
  "Name": "string",
  "Description": "string",
  "GroupType": "AIGC",
  "CreateTime": "string",
  "UpdateTime": "string"
}

{
  "error": "model field is required",
  "type": "invalid_request_error"
}

{
  "error": "invalid or missing API key",
  "type": "auth_error"
}

{
  "error": "rate limit exceeded",
  "type": "rate_limit_error"
}

{
  "error": "upstream provider error",
  "type": "server_error"
}