跳转到主要内容
POST
/
v1
/
files
/
upload
/
base64
Base64 File Upload
curl --request POST \
  --url https://api.foxapi.cc/v1/files/upload/base64 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk...",
  "file_name": "photo.png",
  "auto_cleanup": true
}
'
{
  "id": "file-1757165031-a1b2c3",
  "filename": "photo.png",
  "url": "https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png",
  "size": 204800,
  "created": 1757165031
}

授权

​
Authorization
string
header
必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
file_data
string
必填

Base64 编码的文件内容，支持纯 base64 或 data URL 格式

示例:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk..."

​
file_name
string

文件名（含扩展名），不提供时从 data URL MIME 推断或默认 upload.bin

示例:

"photo.png"

​
auto_cleanup
boolean
默认值:true

存储空间不足时是否自动清理最早上传的文件以腾出空间

说明：

  • 默认 true：自动淘汰最早上传的文件
  • 设为 false：空间不足时直接返回 403 错误
示例:

true

响应

文件上传成功

​
id
string

文件ID

示例:

"file-1757165031-a1b2c3"

​
filename
string

原始文件名

示例:

"photo.png"

​
url
string

上传文件的可访问URL

示例:

"https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png"

​
size
integer

文件大小（字节）

示例:

204800

​
created
integer

上传时间戳

示例:

1757165031