KIE.AI
English
  • English
  • Chinese
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
  1. File Upload API
  • File Upload API Quickstart
  • Base64 File Upload
    POST
  • File Stream Upload
    POST
  • URL File Upload
    POST
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
  1. File Upload API

URL File Upload

POST
/api/file-url-upload
Uploaded files are temporary and will be automatically deleted after 3 days.

Features#

Supports HTTP and HTTPS file links
Automatically downloads remote files and uploads them
Automatically extracts filenames from URLs or uses custom filenames (identical filenames will overwrite old files, potential caching delays may occur)
Automatically identifies MIME types
Returns complete file information and download links
Protected by API Key authentication
Uploaded files are temporary and will be 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 maximum file size is 100MB

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200SuccessResponse
application/json
File uploaded successfully
Body

🟠400BadRequestError
🟠401UnauthorizedError
🔴500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.kie.ai/api/file-url-upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileUrl": "https://example.com/images/sample.jpg",
    "uploadPath": "images/downloaded",
    "fileName": "my-downloaded-image.jpg"
}'
Response 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"
    }
}
Previous
File Stream Upload
Built with