Bild-Upscaling-API: Integrationsleitfaden für Entwickler

Bild-Upscaling in deine App einzubauen war früher ein Riesenprojekt. Du musstest eigene KI-Modelle trainieren. Das kostete Monate und ein großes GPU-Budget. Mit der UpscaleIMG-API schickst du ein Bild und bekommst in Sekunden eine scharfe, hochskalierte Version zurück.

Dieser Leitfaden zeigt dir, wie du UpscaleIMG in dein Projekt integrierst. Mit echten Code-Beispielen und allen verfügbaren Optionen.

Was kann die UpscaleIMG-API?

Die UpscaleIMG-API nutzt Real-ESRGAN. Das ist ein leistungsstarkes KI-Modell für Super-Resolution. Du schickst ein Foto, und die KI fügt beim Hochskalieren realistische Details hinzu. Kanten bleiben scharf. Texturen wirken natürlich. Gesichter behalten ihre Merkmale.

Das bekommst du:

• 2x und 4x Upscaling mit KI-gestützter Detailverbesserung
• Eigene Maße für eine bestimmte Ausgabegröße
• Formatkonvertierung zwischen PNG, JPG und WebP
• Metadaten-Kontrolle zum Entfernen oder Beibehalten von EXIF-Daten
• Bis zu 64 Megapixel Ausgabeauflösung

Die gesamte KI-Verarbeitung läuft auf unseren Servern. Keine GPU nötig bei dir. Kein Modell-Setup. Einfach eine HTTP-Anfrage senden und dein Ergebnis abholen.

Wie startest du mit der API?

Du brauchst einen API-Key für Anfragen. So bekommst du einen:

1. Erstelle ein Konto auf upscaleimg.app
2. Gehe zu deinem Dashboard und generiere einen API-Key
3. Speichere den Key sicher auf deinem Server

Der API-Endpunkt ist:

POST https://upscaleimg.app/api/v1/upscale

Die Authentifizierung nutzt einen Bearer-Token im Authorization-Header. Halte deinen API-Key serverseitig. Zeige ihn nie im Client-Code oder committe ihn ins Repository.

Kostenlose Konten bekommen 2x Upscaling. Abonnenten schalten 4x Upscaling und eigene Maße bis zu 4x der Originalgröße frei.

Wie skalierst du dein erstes Bild hoch?

Der einfachste Aufruf braucht nur ein Bild und einen Skalierungsfaktor. Hier ein curl-Beispiel für 2x Upscaling:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

Die API gibt JSON mit Details zum Original und zum hochskalierten Bild zurück:

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

Das url-Feld gibt dir einen signierten Download-Link. Lade das Bild sofort herunter, da signierte URLs nach kurzer Zeit ablaufen.

Dasselbe in JavaScript:

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`Hochskaliert auf ${data.result.width}x${data.result.height}`);

Und in Python:

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"Hochskaliert auf {data['result']['width']}x{data['result']['height']}")

Welche Optionen unterstützt die API?

Die API akzeptiert mehrere Parameter über Multipart-Formulardaten. Hier die vollständige Liste:

Parameter	Pflicht	Werte	Beschreibung
image	Ja	Datei	PNG-, JPG-, JPEG- oder WebP-Bild
scale	Ja*	2 oder 4	Skalierungsfaktor. *Nicht nötig bei eigenen Maßen.
customWidth	Nein	Ganzzahl	Zielbreite in Pixeln (max. 4x Original)
customHeight	Nein	Ganzzahl	Zielhöhe in Pixeln (max. 4x Original)
objectFit	Nein	cover, contain, fill	Anpassungsmodus bei eigenen Maßen. Standard: cover.
outputFormat	Nein	jpg, jpeg, png, webp	Ausgabeformat. Standard: png.
removeMetadata	Nein	1 oder 0	EXIF-Daten entfernen. Standard: 0 (behalten).

Eigene Maße geben dir präzise Kontrolle. customWidth und customHeight müssen immer zusammen angegeben werden. Die Ausgabe darf nicht kleiner als das Original oder größer als 4x das Original sein (2x bei kostenlosen Konten).

Zum Beispiel, um auf genau 3000x2000 als WebP hochzuskalieren:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

Der objectFit-Parameter funktioniert wie CSS object-fit. cover füllt die Maße exakt (kann zuschneiden). contain passt ins Format (kann Ränder hinzufügen). fill streckt auf die exakte Größe.

Wie gehst du mit Fehlern und Rate-Limits um?

Die API gibt Standard-HTTP-Statuscodes zurück:

Status	Bedeutung
200	Erfolg. Hochskaliertes Bild zurückgegeben.
400	Ungültige Anfrage. Fehlendes Bild, ungültiger Faktor oder Maße außerhalb des Bereichs.
401	Ungültiger oder fehlender API-Key.
403	Verboten. 4x ohne Abo versucht oder CORS-Fehler.
429	Rate-Limit erreicht. Zu viele Anfragen.
500	Serverfehler. Nochmal versuchen.

Alle Fehlerantworten enthalten eine Nachricht:

{"error": "4x upscaling is only available with an active subscription."}

Bei Rate-Limits füge Retry-Logik mit Backoff hinzu:

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

Validiere auch vor dem Senden. Prüfe, ob die Datei ein unterstütztes Format ist (PNG, JPG, WebP). Stelle sicher, dass die Ausgabe 64 Megapixel nicht überschreitet.

Für welche Anwendungsfälle eignet sich die API?

Die UpscaleIMG-API passt perfekt in verschiedene Workflows.

E-Commerce-Plattformen nutzen sie, um Produktfotos von Verkäufern zu verbessern. Viele Uploads sind klein oder von niedriger Qualität. Automatisches Upscaling macht jedes Angebot professioneller. Mehr dazu unter Bilder hochskalieren ohne Qualitätsverlust.

Print-on-Demand-Dienste brauchen hochauflösende Dateien für den Druck. Kunden laden oft Bilder hoch, die am Bildschirm gut aussehen, aber zu klein zum Drucken sind. Du kannst sogar direkt auf 4K hochskalieren.

Apps zur Fotorestaurierung kombinieren Upscaling mit anderen Verbesserungen. Alte oder unscharfe Bilder werden geschärft und vergrößert. Die API übernimmt die rechenintensive KI-Arbeit.

Content-Management-Systeme können Bilder beim Upload automatisch verbessern. So bleibt jedes Bild über einem Mindestqualitätsstandard.

Immobilien- und Kleinanzeigenportale profitieren von einheitlicher Fotoqualität. Makler laden mit unterschiedlichen Kameras hoch. Automatisches Upscaling sorgt für ein professionelles Erscheinungsbild.

Für Batch-Verarbeitung schau dir unseren Leitfaden zum automatischen Hochskalieren von Bildern an. Du kannst auch verschiedene Upscaling-Tools vergleichen.

Bereit loszulegen?

Eine funktionierende Integration hast du in unter einer Stunde. Erstelle dein Konto auf upscaleimg.app, hol dir deinen API-Key und sende dein erstes Testbild.

Starte mit 2x Upscaling bei ein paar Beispielbildern, um die Qualität zu prüfen. Dann baue es in deine Pipeline ein. Der komplette Leitfaden zum Bild-Upscaling deckt alles ab, was du sonst noch über KI-Upscaling wissen musst.

Der kostenlose Tarif reicht zum Testen und für deinen Proof of Concept. Wenn du für 4x Upscaling und höhere Mengen bereit bist, steige auf einen bezahlten Plan um.