> ## Documentation Index > Fetch the complete documentation index at: https://docs.sunoapi.org/llms.txt > Use this file to discover all available pages before exploring further. # File Stream Upload 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 ```bash theme={null} 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" ``` ## OpenAPI ````yaml file-upload-api/file-upload-api.json POST /api/file-stream-upload openapi: 3.0.0 info: title: File Upload API description: >- File Upload Service API Documentation - Supporting multiple file upload methods, uploaded files are temporary and automatically deleted after 3 days version: 1.0.0 contact: name: Technical Support email: support@sunoapi.org servers: - url: https://sunoapiorg.redpandaai.co description: API Server security: - BearerAuth: [] tags: - name: File Upload description: >- Multiple ways to upload temporary files, supporting Base64, file stream, and URL upload, files are automatically deleted after 3 days paths: /api/file-stream-upload: post: summary: File Stream Upload operationId: upload-file-stream requestBody: required: true content: multipart/form-data: schema: type: object properties: file: type: string format: binary description: File to upload (binary data) uploadPath: type: string description: File upload path, without leading or trailing slashes example: images/user-uploads fileName: type: string description: >- 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 required: - file - uploadPath responses: '200': $ref: '#/components/responses/SuccessResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '500': $ref: '#/components/responses/ServerError' components: responses: SuccessResponse: description: File uploaded successfully content: application/json: schema: allOf: - $ref: '#/components/schemas/ApiResponse' - type: object properties: data: $ref: '#/components/schemas/FileUploadResult' 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' BadRequestError: description: Request parameter error content: application/json: schema: $ref: '#/components/schemas/ApiResponse' examples: missing_parameter: summary: Missing required parameter value: success: false code: 400 msg: 'Missing required parameter: uploadPath' invalid_format: summary: Format error value: success: false code: 400 msg: 'Base64 decoding failed: Invalid Base64 format' UnauthorizedError: description: Unauthorized access content: application/json: schema: $ref: '#/components/schemas/ApiResponse' example: success: false code: 401 msg: 'Authentication failed: Invalid API Key' ServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiResponse' example: success: false code: 500 msg: Internal server error schemas: ApiResponse: type: object properties: success: type: boolean description: Whether the request was successful code: $ref: '#/components/schemas/StatusCode' msg: type: string description: Response message example: File uploaded successfully required: - success - code - msg FileUploadResult: type: object properties: fileName: type: string description: File name example: uploaded-image.png filePath: type: string description: Complete file path in storage example: images/user-uploads/uploaded-image.png downloadUrl: type: string format: uri description: File download URL example: >- https://tempfile.redpandaai.co/xxx/images/user-uploads/uploaded-image.png fileSize: type: integer description: File size in bytes example: 154832 mimeType: type: string description: File MIME type example: image/png uploadedAt: type: string format: date-time description: Upload timestamp example: '2025-01-01T12:00:00.000Z' required: - fileName - filePath - downloadUrl - fileSize - mimeType - uploadedAt StatusCode: type: integer enum: - 200 - 400 - 401 - 405 - 500 description: Response status code x-enumDescriptions: '200': Success - Request has been processed successfully '400': >- Bad Request - Request parameters are incorrect or missing required parameters '401': Unauthorized - Authentication credentials are missing or invalid '405': Method Not Allowed - Request method is not supported '500': >- Server Error - An unexpected error occurred while processing the request securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All APIs require authentication via Bearer Token. Get API Key: 1. Visit [API Key Management Page](https://sunoapi.org/api-key) 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 ````