创建素材
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
向指定素材分组中添加一个素材。素材文件需通过 URL 引用，支持图片、视频、音频三种类型。
素材创建后状态为 Processing（处理中），处理完成后变为 Active（可用）。
可通过 GET /v1/assets/{assetId} 轮询素材状态。
素材创建成功后，可在视频生成等接口中通过 asset://<素材ID> 格式引用。
文件大小限制：
| 类型 | 格式 | 最大大小 |
|---|---|---|
| Image | JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF | 30 MB |
| Video | MP4, MOV | 50 MB |
| Audio | WAV, MP3 | 15 MB |
图像素材上传规范
单张图片要求：
- 格式：JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC / HEIF
- 宽高比（宽/高）：
(0.4, 2.5) - 宽高像素：
(300, 6000) - 大小：单张小于 30 MB
多素材同组建议： 为保证生成视频中人物面部、服装细节与上传素材一致，推荐按以下规则将同一人物的多张素材传入同一资产组：
人物面部
- 用途：通过上传面部特写图，让生成视频的人物面部与素材一致
- 版式：竖版，面部占画面 2/3 左右
- 内容：正面无表情特写，肩部以上
人物服装细节
- 用途：通过上传同一人物的三视图（前 / 侧 / 后），让生成视频中服装细节与素材一致
- 版式：横版，三视图平铺展示
Authorization
BearerAuth AuthorizationBearer <token>
API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
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
curl -X post "https://api.xrtoken.net/v1/assets" \ -H "Content-Type: application/json" \ -d '{ "group_id": "group-xxxxxxxxxxxx", "url": "https://example.com/image.png", "asset_type": "Image" }'{
"Id": "string",
"Name": "string",
"AssetType": "Image",
"Status": "Active",
"GroupId": "string",
"URL": "string",
"CreateTime": "string",
"UpdateTime": "string",
"Error": {
"Code": "string",
"Message": "string"
}
}{
"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": "rate limit exceeded",
"type": "rate_limit_error"
}{
"error": "upstream provider error",
"type": "server_error"
}