文件上传 API

/v1/files/upload

通用

把参考图、参考视频、参考音频上传到 R2，随后把返回的 URL 用在模型请求或白名单请求里。

鉴权与连接

Base URL: https://backend:8000
Authorization: Authorization: Bearer YOUR_API_KEY
Method: POST
Path: /v1/files/upload

请求 / 响应 JSON

// REQUEST

{
  "kind": "image",
  "purpose": "reference",
  "file": "@demo.png"
}

// RESPONSE

{
  "file_name": "demo.png",
  "mime_type": "image/png",
  "size": 12345,
  "kind": "image",
  "purpose": "reference",
  "storage": "r2",
  "key": "tenant/1/user/7/reference/image/2026/03/26/example-upload.png",
  "url": "https://file.example.com/tenant/1/user/7/reference/image/2026/03/26/example-upload.png"
}

请求字段 / 响应字段

// INPUT SCHEMA

字段	类型	必填
kind	string	Y
purpose	string	Y
file	binary	Y

// RESPONSE SCHEMA

字段	类型	必填
file_name	string	Y
mime_type	string	Y
size	integer	Y
kind	string	Y
purpose	string	Y
storage	string	Y
key	string	Y
url	string	Y

代码示例

cURLrequest.sh

curl -X POST "https://backend:8000/v1/files/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "kind=image" \
  -F "purpose=reference" \
  -F "file=@demo.png"