API-Dokumentation

Kostenlosen Schlüssel anfordern — E-Mail-Adresse genügt, in einer Minute erledigt.

Die API besteht aus einem einzigen Endpoint. Sie ist absichtlich kompatibel zur Chevereto-v3-API, damit bestehende Skripte ohne Anpassung weiterlaufen.

Endpoint

POST https://imguploader.de/api/1/upload

Automatisches Löschen

Über expiration legst du fest, wie lange ein Bild erreichbar bleibt. Danach werden Datei, Vorschaubilder und Bildseite restlos entfernt.

Schreibweise	Bedeutung
`15m` · `2h` · `7d` · `1w`	Zahl mit Einheit — Minuten, Stunden, Tage, Wochen
`900`	reine Zahl = Sekunden
`PT15M` · `P1D` · `P1W`	ISO-8601-Dauer (wie bei Chevereto)
`0` · `nie` · leer	bleibt dauerhaft

Beim Anfordern des Schlüssels kannst du eine Vorgabe hinterlegen. Dann gilt sie für jeden Upload, ohne dass du etwas mitschicken musst — eine Angabe in der Anfrage hat aber immer Vorrang.

curl -F "key=DEIN_SCHLUESSEL"      -F "source=@bild.jpg"      -F "expiration=15m"      https://imguploader.de/api/1/upload

Parameter

Feld	Pflicht	Beschreibung
`key`	ja	Dein API-Schlüssel. Alternativ als Header `X-API-Key`.
`source`	ja	Das Bild: Datei-Upload (multipart), Base64-String oder eine http(s)-URL.
`format`	nein	`json` (Standard) oder `txt` für nur die URL.
`title`	nein	Titel des Bildes (auch für den Seitentitel).
`description`	nein	Bildbeschreibung.
`expiration`	nein	Wann das Bild automatisch verschwindet. Mehrere Schreibweisen erlaubt, siehe unten. Ohne Angabe gilt die Vorgabe deines Schlüssels.

Beispiel: curl

curl -X POST https://imguploader.de/api/1/upload \
  -F "key=DEIN_KEY" \
  -F "source=@bild.jpg" \
  -F "format=json"

Beispiel: Base64 (PHP)

$post = [
  'key'    => 'DEIN_KEY',
  'source' => base64_encode(file_get_contents('bild.jpg')),
  'format' => 'json',
];
$ch = curl_init('https://imguploader.de/api/1/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = json_decode(curl_exec($ch), true);
echo $json['image']['url'];

Antwort

{
  "status_code": 200,
  "success": { "message": "image uploaded", "code": 200 },
  "image": {
    "name": "59ab1f474a31",
    "extension": "jpg",
    "size": 203648,
    "width": 1280,
    "height": 720,
    "url": "https://imguploader.de/images/2026/08/01/59ab1f474a31.jpg",
    "url_viewer": "https://imguploader.de/image/TQ38",
    "display_url": "https://imguploader.de/images/2026/08/01/59ab1f474a31.md.jpg",
    "thumb": { "url": "https://imguploader.de/images/2026/08/01/59ab1f474a31.th.jpg" },
    "delete_url": "https://imguploader.de/delete/TQ38/<hash>"
  },
  "status_txt": "OK"
}

Fehler

Im Fehlerfall ist status_code ≠ 200 und das Feld error enthält message, code und context. Der HTTP-Status entspricht dem Fehlercode.

Grenzen

Maximale Dateigröße: 32 MB
Erlaubte Formate: JPG, PNG, GIF, WebP, AVIF, BMP, TIFF, SVG
Ohne gültigen Schlüssel antwortet der Endpoint mit 403.

Schlüssel bekommen

Der Schlüssel ist kostenlos und sofort verfügbar — ohne Registrierung, ohne Konto. Du brauchst nur eine E-Mail-Adresse:

Auf imguploader.de/api-key die Adresse eintragen.
Den Bestätigungslink in der Mail öffnen.
Der Schlüssel wird sofort angezeigt und zusätzlich zugeschickt.

Kostenlosen Schlüssel anfordern

Dabei kannst du gleich eine Standard-Löschfrist hinterlegen, die dann für jeden Upload mit diesem Schlüssel gilt.