POST
/
api
/
file-base64-upload
curl --request POST \
--url https://sunoapiorg.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%

Authorizations

Authorization
string
header
required

所有 API 需要通过 Bearer Token 进行身份验证。

获取 API Key:

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

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

注意:

  • 请妥善保管您的 API Key,不要与他人分享
  • 如果怀疑 API Key 已泄露,请立即在管理页面重置

Body

application/json

Response

200
application/json

文件上传成功

The response is of type object.