curl --request POST \
--url https://apibox.redpandaai.co/api/file-url-upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fileUrl": "https://example.com/images/sample.jpg",
"uploadPath": "images/downloaded",
"fileName": "my-downloaded-image.jpg"
}
'{
"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
URL 文件上传
POST
/
api
/
file-url-upload
curl --request POST \
--url https://apibox.redpandaai.co/api/file-url-upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fileUrl": "https://example.com/images/sample.jpg",
"uploadPath": "images/downloaded",
"fileName": "my-downloaded-image.jpg"
}
'{
"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天后自动删除。
功能特点
- 支持 HTTP 和 HTTPS 文件链接
- 自动下载远程文件并上传
- 自动从 URL 提取文件名或使用自定义文件名
- 自动识别 MIME 类型
- 返回完整的文件信息和下载链接
- API Key 认证保护
- 上传文件为临时文件,3天后自动删除
支持的协议
- HTTP:
http://example.com/file.jpg - HTTPS:
https://example.com/file.jpg
使用场景
- 从其他服务迁移文件
- 批量下载和存储网络资源
- 备份远程文件
- 缓存外部资源
重要说明
- 确保提供的 URL 可公开访问
- 下载超时时间为 30 秒
- 推荐文件大小上限为 100MB
授权
所有 API 需要通过 Bearer Token 进行身份验证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方法: 在请求头中添加: Authorization: Bearer YOUR_API_KEY
注意:
- 请妥善保管您的 API Key,不要与他人分享
- 如果怀疑 API Key 已泄露,请立即在管理页面重置
请求体
application/json
