文件流上传

POST

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

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

功能特点

支持多种文件类型的二进制流上传

适合大文件上传，传输效率高

自动识别 MIME 类型

支持自定义文件名或自动生成（相同文件名会覆盖旧文件，可能存在缓存延迟）

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

API Key 认证保护

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

使用建议

推荐用于大文件（>10MB）

支持多种格式：图片、视频、文档等

传输效率比 Base64 格式高约 33%

示例命令

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params multipart/form-dataRequired

Responses

🟢200SuccessResponse

application/json

File uploaded successfully

Body

🟠400BadRequestError

🟠401UnauthorizedError

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://kieai.redpandaai.co/api/file-stream-upload' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'uploadPath="images/user-uploads"' \
--form 'fileName="my-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"
    }
}

Base64 文件上传

URL 文件上传

文件流上传

功能特点#

使用建议#

示例命令#

Request

Responses

功能特点

使用建议

示例命令