素材库火山兼容端点
火山 Ark Open API 格式的素材库兼容入口。把 base URL 指向 XRToken 后,
请求路径 / 参数 / 响应与火山官方保持一致,鉴权用 XRToken API key
(Authorization: Bearer tr-xxx 或 x-api-key: tr-xxx),不需要 AK/SK。
通过 query 参数 Action 区分操作:
Action=CreateAssetGroup:创建素材组。ProjectName非必填:不传时自动使用网关项目(当前xrtoken);显式传值(包括default)原样透传。Action=CreateAsset:创建素材。ProjectName非必填:不传时自动使用网关项目(当前xrtoken);显式传值(包括default)原样透传;Name可选。Action=GetAssetGroup:查询素材组,body 传{"Id": "group-xxx"}。Action=GetAsset:查询素材,body 传{"Id": "asset-xxx"}。
响应沿用火山 ResponseMetadata / Result 信封,并保持素材库账号隔离
(只能创建 / 查询自己名下的分组和素材)。
Authorization
BearerAuth API 密钥认证(OpenAI 格式)。在 Authorization 请求头中传入:
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Query Parameters
操作类型:
CreateAssetGroup-- 创建素材组CreateAsset-- 创建素材GetAssetGroup-- 查询素材组GetAsset-- 查询素材
"CreateAssetGroup" | "CreateAsset" | "GetAssetGroup" | "GetAsset"接口版本,默认 2024-01-01。
"2024-01-01"Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X post "https://api.xrtoken.net/?Action=CreateAssetGroup" \ -H "Content-Type: application/json" \ -d '{ "Name": "my-assets" }'{}{
"error": "model field is required",
"type": "invalid_request_error"
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}{
"error": "upstream provider error",
"type": "server_error"
}