Skip to main content
POST
/
api
/
v1
/
files
/
upload
/
stream
File Stream Upload
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/stream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file
{
  "success": true,
  "code": 200,
  "msg": "File uploaded successfully",
  "data": {
    "file_id": "file_abc123",
    "file_name": "photo.png",
    "original_name": "photo.png",
    "file_size": 2048,
    "mime_type": "image/png",
    "upload_path": "photos",
    "file_url": "https://files.evolink.ai/photos/photo.png",
    "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

multipart/form-data
​
file
file
required

File binary data

Note:

  • Upload via form-data format
  • System will automatically identify file type
  • Maximum 1 image per request
  • Currently supports uploading files in: image/jpeg, image/png, image/gif, image/webp formats only
​
upload_path
string

Custom upload path

Note:

  • Supports underscore naming: upload_path
  • Supports camelCase naming: uploadPath
  • If not specified, system will automatically categorize based on file type
Example:

"photos"

​
file_name
string

Custom file name

Note:

  • Supports underscore naming: file_name
  • Supports camelCase naming: fileName
  • If not specified, system will automatically generate a unique file name
Example:

"photo.png"

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