上传文件
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
上传一个文件到账号下的素材库。请求体为 multipart/form-data,
包含 file 字段(必填,二进制)和可选的 purpose 字段。
文件以流式方式直接写入对象存储,不会在网关缓冲,单文件上限 500 MB。
支持任意 MIME,服务端按类型归类为 image / video / audio / file。
上传后会占用账号 5 GB 存储配额;超过配额的文件仍可上传,但仅保留 24 小时。
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"
}