跳转到主要内容
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

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
​
fileUrl
string<uri>
required

文件下载链接，必须是有效的HTTP或HTTPS地址

Example:

"https://example.com/images/sample.jpg"

​
uploadPath
string
required

文件上传路径，不包含前后斜杠

Example:

"images/downloaded"

​
fileName
string

文件名称（可选），包含文件扩展名。如不提供，系统将自动生成随机文件名。如果指定的文件名已存在，旧文件将被覆盖。注意：由于缓存机制，文件覆盖可能不会立即生效。

Example:

"sample-image.jpg"

Response

文件上传成功

​
success
boolean
required

请求是否成功

​
code
enum<integer>
required

响应状态码

Available options:
200,
400,
401,
405,
500
​
msg
string
required

响应消息

Example:

"文件上传成功"

​
data
object
⌘I