curl --request POST \
--url https://apibox.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"
}
}文件上传API
Base64 文件上传
POST
/
api
/
file-base64-upload
curl --request POST \
--url https://apibox.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%
授权
所有 API 需要通过 Bearer Token 进行身份验证。
获取 API Key：
- 访问 API Key 管理页面 获取您的 API Key
使用方法： 在请求头中添加： Authorization: Bearer YOUR_API_KEY
注意：
- 请妥善保管您的 API Key，不要与他人分享
- 如果怀疑 API Key 已泄露，请立即在管理页面重置
请求体
application/json
Base64编码的文件数据。支持纯Base64字符串或data URL格式（如：data:image/png;base64,iVBOR...）
示例:
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
文件上传路径，不包含前后斜杠
示例:
"images/base64"
文件名称（可选），包含文件扩展名。如不提供，系统将自动生成随机文件名。如果指定的文件名已存在，旧文件将被覆盖。注意：由于缓存机制，文件覆盖可能不会立即生效。
示例:
"my-image.png"