> ## 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. # URL File Upload Download files from URLs and upload them as temporary files. Note: Uploaded files are temporary and automatically deleted after 3 days. ### Features * Supports HTTP and HTTPS file links * Automatically downloads remote files and uploads them * Automatically extracts file names from URLs or uses custom file names * Automatic MIME type recognition * Returns complete file information and download links * API Key authentication protection * Uploaded files are temporary and automatically deleted after 3 days ### Supported Protocols * **HTTP**: `http://example.com/file.jpg` * **HTTPS**: `https://example.com/file.jpg` ### Use Cases * Migrating files from other services * Batch downloading and storing web resources * Backing up remote files * Caching external resources ### Important Notes * Ensure the provided URL is publicly accessible * Download timeout is 30 seconds * Recommended file size limit is 100MB ## OpenAPI ````yaml file-upload-api/file-upload-api.json POST /api/file-url-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-url-upload: post: summary: URL File Upload operationId: upload-file-url requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UrlUploadRequest' examples: image_from_url: summary: Download image from URL value: fileUrl: https://example.com/images/sample.jpg uploadPath: images/downloaded fileName: my-downloaded-image.jpg document_from_url: summary: Download document from URL value: fileUrl: https://example.com/docs/manual.pdf uploadPath: documents/manuals responses: '200': $ref: '#/components/responses/SuccessResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '500': $ref: '#/components/responses/ServerError' components: schemas: UrlUploadRequest: type: object properties: fileUrl: type: string format: uri description: File download URL, must be a valid HTTP or HTTPS address example: https://example.com/images/sample.jpg uploadPath: type: string description: File upload path, without leading or trailing slashes example: images/downloaded fileName: type: string description: >- File name (optional), including file extension. If not provided, a random filename will be generated. If the same filename already exists, the old file will be overwritten, but changes may not be immediately visible due to caching example: sample-image.jpg required: - fileUrl - uploadPath 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 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 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 ````