Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-2614271305.9 KB
File Upload

URL File Upload

  • Upload by providing a remote file URL
  • System will automatically download and store the remote file
  • Suitable for migrating files from other servers
  • Files will expire after 72 hours
  • Current user quota is limited. Uploads will fail when quota is exhausted. Please save locally if persistent storage is needed

Note: The file upload API base URL ishttps://files-api.evolink.ai

post/api/v1/files/upload/url

Request body

file_urlstring uri required

Remote file URL

Requirements:

  • Must be a publicly accessible URL
  • Supports HTTP and HTTPS protocols
  • System will automatically download the file content from this URL
  • Maximum 1 image per request
  • Currently supports uploading files in: image/jpeg, image/png, image/gif, image/webp formats only
upload_pathstring

Custom upload path

Note:

  • If not specified, system will automatically categorize based on file type
file_namestring

Custom file name

Note:

  • If not specified, system will automatically generate a unique file name

Example request

{
  "file_url": "https://example.com/image.jpg",
  "upload_path": "downloads",
  "file_name": "downloaded.jpg"
}

Response

File uploaded successfully

successboolean

Whether the request was successful

codeinteger

Response status code

msgstring

Response message

Example response

{
  "success": true,
  "code": 200,
  "msg": "File uploaded successfully",
  "data": {
    "file_id": "file_abc123",
    "file_name": "downloaded.jpg",
    "original_name": "downloaded.jpg",
    "file_size": 2048,
    "mime_type": "image/jpeg",
    "upload_path": "downloads",
    "file_url": "https://files.evolink.ai/downloads/downloaded.jpg",
    "download_url": "https://files.evolink.ai/api/v1/files/download/file_abc123",
    "upload_time": "2025-10-09T00:00:00+08:00",
    "expires_at": "2025-10-12T00:00:00+08:00"
  }
}