Zum Hauptinhalt springen
POST
/
api
/
v1
/
files
/
upload
/
url
URL-Datei-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": "Datei erfolgreich hochgeladen",
  "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"
  }
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
file_url
string<uri>
erforderlich

Remote-Datei-URL

Anforderungen:

  • Muss eine öffentlich zugängliche URL sein
  • Unterstützt HTTP- und HTTPS-Protokolle
  • System lädt den Dateiinhalt automatisch von dieser URL herunter
  • Maximal 1 Bild pro Anfrage
  • Derzeit werden nur Dateien in folgenden Formaten unterstützt: image/jpeg, image/png, image/gif, image/webp
Beispiel:

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

​
upload_path
string

Benutzerdefinierter Upload-Pfad

Hinweis:

  • Wenn nicht angegeben, kategorisiert das System automatisch basierend auf dem Dateityp
Beispiel:

"downloads"

​
file_name
string

Benutzerdefinierter Dateiname

Hinweis:

  • Wenn nicht angegeben, generiert das System automatisch einen eindeutigen Dateinamen
Beispiel:

"downloaded.jpg"

Antwort

200 - application/json

Datei erfolgreich hochgeladen

​
success
boolean

Ob die Anfrage erfolgreich war

Beispiel:

true

​
code
integer

Antwort-Statuscode

Beispiel:

200

​
msg
string

Antwortnachricht

Beispiel:

"Datei erfolgreich hochgeladen"

​
data
object