上传的文件为临时文件,3天后自动删除。
功能特点
- 支持 Base64 编码数据和 data URL 格式
- 自动识别 MIME 类型和文件扩展名
- 支持自定义文件名或自动生成(相同文件名会覆盖旧文件,可能存在缓存延迟)
- 返回完整的文件信息和下载链接
- API Key 认证保护
- 上传文件为临时文件,3天后自动删除
支持的格式
- 纯 Base64 字符串:
iVBORw0KGgoAAAANSUhEUgAA... - Data URL 格式:
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...
使用建议
- 推荐用于小文件如图片
- 大文件(>10MB)建议使用文件流上传 API
- Base64 编码会使数据传输量增加约 33%
Authorizations
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY
Body
application/json
Base64 编码的文件数据。支持纯 Base64 字符串或 data URL 格式
Example:
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
文件上传路径,不带首尾斜杠
Example:
"images/base64"
文件名(可选),包含文件扩展名。如不提供文件名,将自动生成随机文件名。若新上传的文件名与已存在文件名相同,则旧文件将被覆盖,但由于缓存原因,此更改可能不会立即生效
Example:
"my-image.png"
