File Stream Upload

POST

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

Uploaded files are deleted 24 hours after upload.

Features

Supports binary stream upload for multiple file types

Suitable for large file uploads with high transmission efficiency

Automatically identifies MIME types

Supports custom filenames or auto-generation (identical filenames will overwrite old files, potential caching delays may occur)

Returns complete file information and download links

Protected by API Key authentication

Usage Recommendations

Recommended for large files (>10MB)

Supports multiple formats: images, videos, documents, etc.

Avoids the ~33% size overhead of Base64 encoding.

Example Command

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

Bodyapplication/json

🟠400BadRequestError

🟠401UnauthorizedError

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '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 File Upload

URL File Upload

File Stream Upload

Features#

Usage Recommendations#

Example Command#

Request

Responses

Features

Usage Recommendations

Example Command