Skip to main content
POST
/
api
/
v1
/
files
/
upload
/
url
URL File Upload
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_url": "https://example.com/image.jpg"
}
'
{
  "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"
  }
}

Authorizations

​
Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to obtain your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
file_url
string<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
Example:

"https://example.com/image.jpg"

​
upload_path
string

Custom upload path

Note:

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

"downloads"

​
file_name
string

Custom file name

Note:

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

"downloaded.jpg"

Response

200 - application/json

File uploaded successfully

​
success
boolean

Whether the request was successful

Example:

true

​
code
integer

Response status code

Example:

200

​
msg
string

Response message

Example:

"File uploaded successfully"

​
data
object