上传文件
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
上传一个文件到账号下的素材库。请求体为 multipart/form-data，需要包含 file 字段（二进制）。可选 purpose 字段作为业务用途标签。
- 单文件上限：500 MB
- MIME 类型：任意；服务端按类型归类为
image/video/audio/file - 配额：占用账号 5 GB 存储。超过配额仍可上传，但只保留 24 小时
- 流式直传：请求体直接写入对象存储，不在网关缓冲
返回体包含 1 小时有效的 url 字段，可直接用于下载或引用。
Authorization
BearerAuth AuthorizationBearer <token>
API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X post "https://api.xrtoken.net/v1/files" \ -F file="string"{
"id": "string",
"object": "file",
"bytes": 0,
"created_at": 0,
"filename": "string",
"purpose": "string",
"mime_type": "string",
"type": "image",
"url": "string",
"expires_at": 0
}{
"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"
}