URL 文件上传

POST

https://kieai.redpandaai.co/api/file-url-upload

上传的文件为临时文件，3天后自动删除。

功能特点

支持 HTTP 和 HTTPS 文件链接

自动下载远程文件并上传

自动从 URL 提取文件名或使用自定义文件名（相同文件名会覆盖旧文件，可能存在缓存延迟）

自动识别 MIME 类型

返回完整的文件信息和下载链接

API Key 认证保护

上传文件为临时文件，3天后自动删除

支持的协议

HTTP：http://example.com/file.jpg

HTTPS：https://example.com/file.jpg

使用场景

从其他服务迁移文件

批量下载和存储网络资源

备份远程文件

缓存外部资源

重要说明

确保提供的 URL 可公开访问

下载超时时间为 30 秒

推荐文件大小上限为 100MB

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200SuccessResponse

application/json

File uploaded successfully

Body

🟠400BadRequestError

🟠401UnauthorizedError

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

从 URL 下载图片从 URL 下载文档

curl --location --request POST 'https://kieai.redpandaai.co/api/file-url-upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileUrl": "https://example.com/images/sample.jpg",
    "uploadPath": "images/downloaded",
    "fileName": "my-downloaded-image.jpg"
}'

Response Example

200 - Successful Example

{
    "success": true,
    "code": 200,
    "msg": "File uploaded successfully",
    "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"
    }
}

文件流上传

URL 文件上传

功能特点#

支持的协议#

使用场景#

重要说明#

Request

Responses

功能特点

支持的协议

使用场景

重要说明