跳转到主要内容
POST
/
api
/
file-base64-upload
curl --request POST \
  --url https://kieai.redpandaai.co/api/file-base64-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "base64Data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==",
  "uploadPath": "images/base64",
  "fileName": "test-image.png"
}
'
{
  "success": true,
  "code": 200,
  "msg": "文件上传成功",
  "data": {
    "fileName": "uploaded-image.png",
    "filePath": "images/user-uploads/uploaded-image.png",
    "downloadUrl": "https://tempfile.redpandaai.co/xxx/images/user-uploads/uploaded-image.png",
    "fileSize": 154832,
    "mimeType": "image/png",
    "uploadedAt": "2025-01-01T12:00:00.000Z"
  }
}
上传的文件为临时文件，3天后自动删除。

​
功能特点

  • 支持 Base64 编码数据和 data URL 格式
  • 自动识别 MIME 类型和文件扩展名
  • 支持自定义文件名或自动生成（相同文件名会覆盖旧文件，可能存在缓存延迟）
  • 返回完整的文件信息和下载链接
  • API Key 认证保护
  • 上传文件为临时文件，3天后自动删除

​
支持的格式

  • 纯 Base64 字符串：iVBORw0KGgoAAAANSUhEUgAA...
  • Data URL 格式：data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...

​
使用建议

  • 推荐用于小文件如图片
  • 大文件（>10MB）建议使用文件流上传 API
  • Base64 编码会使数据传输量增加约 33%

授权

​
Authorization
string
header
必填

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加： Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
base64Data
string
必填

Base64 编码的文件数据。支持纯 Base64 字符串或 data URL 格式

示例:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."

​
uploadPath
string
必填

文件上传路径，不带首尾斜杠

示例:

"images/base64"

​
fileName
string

文件名（可选），包含文件扩展名。如不提供文件名，将自动生成随机文件名。若新上传的文件名与已存在文件名相同，则旧文件将被覆盖，但由于缓存原因，此更改可能不会立即生效

示例:

"my-image.png"

响应

文件上传成功

​
success
boolean
必填

请求是否成功

​
code
enum<integer>
必填

响应状态码

Code说明
200成功 - 请求已成功处理
400参数错误 - 请求参数不正确或缺少必填参数
401未授权 - 缺少身份验证凭据或凭据无效
405方法不被允许 - 请求方法不支持
500服务器错误 - 处理请求时发生意外错误
可用选项:
200,
400,
401,
405,
500
​
msg
string
必填

响应消息

示例:

"文件上传成功"

​
data
object
必填