Saltar al contenido principal
POST
/
api
/
v1
/
files
/
upload
/
url
Carga de archivos por URL
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": "FileImageSource",
  "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"
  }
}

Autorizaciones

​
Authorization
string
header
requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json
​
file_url
string<uri>
requerido

URL de archivo remoto

Requisitos:

  • Debe ser una URL de acceso público
  • Admite protocolos HTTP y HTTPS
  • El sistema descargará automáticamente el contenido del archivo desde esta URL
  • Máximo 1 imagen por solicitud
  • Actualmente solo admite la carga de archivos en formatos: image/jpeg, image/png, image/gif, image/webp
Ejemplo:

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

​
upload_path
string

Ruta de subida personalizada

Nota:

  • Si no se especifica, el sistema categorizará automáticamente según el tipo de archivo
Ejemplo:

"downloads"

​
file_name
string

Nombre de archivo personalizado

Nota:

  • Si no se especifica, el sistema generará automáticamente un nombre de archivo único
Ejemplo:

"downloaded.jpg"

Respuesta

200 - application/json

FileImageSource

​
success
boolean

Si la solicitud fue exitosa

Ejemplo:

true

​
code
integer

Código de estado de respuesta

Ejemplo:

200

​
msg
string

Mensaje de respuesta

Ejemplo:

"FileImageSource"

​
data
object