XRToken API 文档

上传文件

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

上传一个文件到账号下的素材库。请求体为 multipart/form-data, 包含 file 字段(必填,二进制)和可选的 purpose 字段。

文件以流式方式直接写入对象存储,不会在网关缓冲,单文件上限 500 MB。 支持任意 MIME,服务端按类型归类为 image / video / audio / file

上传后会占用账号 5 GB 存储配额;超过配额的文件仍可上传,但仅保留 24 小时。

POST
/v1/files

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"
}