Skip to main content
POST
/
api
/
file-stream-upload
File Stream Upload
curl --request POST \
  --url https://sunoapiorg.redpandaai.co/api/file-stream-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form uploadPath=images/user-uploads \
  --form fileName=my-image.jpg \
  --form file=@example-file
{
  "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"
  }
}
Upload temporary files via multipart/form-data format. Note: Uploaded files are temporary and automatically deleted after 3 days.

​
Features

  • Supports binary stream upload for various file types
  • Suitable for large file uploads with high transmission efficiency
  • Automatic MIME type recognition
  • Support for custom file names or using original file names
  • Returns complete file information and download links
  • API Key authentication protection
  • Uploaded files are temporary and automatically deleted after 3 days

​
Usage Recommendations

  • Recommended for large files (>10MB)
  • Supports various formats: images, videos, documents, etc.
  • Transmission efficiency is approximately 33% higher than Base64 format

​
Example Command

curl -X POST https://sunoapiorg.redpandaai.co/api/file-stream-upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your-file.jpg" \
  -F "uploadPath=images/user-uploads" \
  -F "fileName=custom-name.jpg"

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

multipart/form-data
​
file
file
required

File to upload (binary data)

​
uploadPath
string
required

File upload path, without leading or trailing slashes

Example:

"images/user-uploads"

​
fileName
string

File name (optional), including file extension. If not provided, the original filename will be used. If the same filename already exists, the old file will be overwritten, but changes may not be immediately visible due to caching

Example:

"my-image.jpg"

Response

File uploaded successfully

​
success
boolean
required

Whether the request was successful

​
code
enum<integer>
required

Response status code

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

Response message

Example:

"File uploaded successfully"

​
data
object
⌘I