Was ist eine Hochskalierungs-API und wie funktioniert sie?

Es ist ein HTTP-Endpunkt, der die Auflösung eines Bildes mit einem trainierten Modell erhöht. Statt wie beim Skalieren zwischen vorhandenen Pixeln zu interpolieren, sagt das Modell die Details voraus, die eine höher aufgelöste Fassung des Bildes enthalten würde — Kanten, Textur und Struktur — und rekonstruiert sie. Sie senden das Bild per POST und lesen das vergrößerte Ergebnis aus der Antwort.

Welche Skalierungsfaktoren und Bildtypen werden unterstützt?

Der Parameter factor akzeptiert 2 oder 4 und steht standardmäßig auf 4. Die Eingabe kann JPEG (JPG), PNG und WebP bis 25 MB sein, die Ausgabe wird als jpeg (Standard) oder png zurückgegeben.

Wie funktioniert die Preisgestaltung der Hochskalierungs-API?

Die Kosten folgen dem Faktor: 2 Credits bei factor=2 und 4 Credits bei factor=4 (dem Standard). Starter gibt Ihnen 400 Credits im Monat für 9,99 $ und Pro 1.400 für 29,99 $, und nicht genutzte Credits werden übertragen, solange Sie abonniert bleiben. Abrechnung über Credits heißt: Ein Monat mit viel Volumen und ein ruhiger Monat kosten Sie pro Bild dasselbe.

Kann die API auch die Qualität verbessern, Unschärfe entfernen oder alte Fotos restaurieren?

Die Hochskalierung rekonstruiert beim Vergrößern Details, was weiche Bilder nebenbei schärft, und das sharpen-Flag treibt das weiter. Für beschädigte oder verblasste Fotografien — Kratzer, Risse, Farbverlust — nehmen Sie stattdessen die Fotorestaurierungs-API, die auf Reparatur statt auf Auflösung ausgelegt ist.

Ist die Hochskalierung synchron oder asynchron?

Synchron. Es gibt keine Job-ID abzufragen und keinen Webhook einzurichten — das hochskalierte Bild steckt im Body derselben Antwort, mit einer Obergrenze von 60 Sekunden pro Anfrage.

Darf ich hochskalierte Bilder kommerziell nutzen?

Ja. Alle Tarife, auch der kostenlose, enthalten vollständige kommerzielle Nutzungsrechte, und kein Ergebnis trägt ein Wasserzeichen. Sie dürfen alles, was die API zurückgibt, verkaufen, drucken oder veröffentlichen.

Speichern Sie die Bilder, die ich hochskaliere?

Nein. Die API ist zustandslos: Sie legt kein Projekt an, speichert keine Datei und behält Ihr Bild nicht. Ihr Upload wird in ein temporäres Objekt geschrieben, verarbeitet und gelöscht, sobald die Antwort zurückgegeben wurde. Erhalten bleibt nur ein Nutzungsprotokoll, das festhält, dass ein Aufruf stattgefunden hat und wie viele Credits er gekostet hat. Ihre Bilder werden nie zum Trainieren von Modellen verwendet.

2–4 Credits pro Aufruf

Hochskalierungs-API

Erhöhen Sie die Bildauflösung um 2x oder 4x aus Ihrem eigenen Backend. Optionale Gesichtsverbesserung und Schärfung, Ausgabe als JPEG oder PNG, und ein Preis, der mit dem angeforderten Faktor skaliert.

REST · JSON
Kein Wasserzeichen
Nichts wird gespeichert

API-Schlüssel holen Zur Dokumentation

endpoint

POST /v1/upscale-image

Basis-URL: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Kosten: 2–4 Credits
Eingabe: JPEG (JPG), PNG and WebP · max 25 MB

01 — Überblick

Was ist die Hochskalierungs-API?

Die ImgGen AI Hochskalierungs-API ist ein REST-Endpunkt, der die Auflösung eines Bildes mit KI statt mit einfacher Interpolation erhöht. Sie rekonstruiert Kanten, Texturen und feine Details, anstatt Pixel zu strecken — die Ausgabe bleibt also scharf. Sie senden ein Bild und einen Skalierungsfaktor, und das Ergebnis in höherer Auflösung kommt in derselben Anfrage zurück.

Es ist einer von sieben Endpunkten der ImgGen AI Bildbearbeitungs-API, die alle denselben API-Schlüssel, dieselbe Basis-URL und dasselbe Anfrage- und Antwortformat teilen. Wenn Sie diese Funktion auch im Browser statt aus dem Code heraus brauchen: Dasselbe KI-Modell treibt das Tool AI Image Upscaler an.

02 — Anfrage

Anfrageparameter

Senden Sie eine POST-Anfrage an https://app.imggen.ai/v1/upscale-image, authentifiziert mit einem API-Schlüssel im Authorization-Header.

Von diesem Endpunkt akzeptierte Parameter
Parameter	Typ	Pflicht	Standard	Beschreibung
image	file	PFLICHT	—	Skalierungsfaktor. Akzeptiert 2 oder 4.
factor	number	optional	4	Wendet zusätzliche Gesichtsrekonstruktion an. Nützlich für Porträts und Gruppenfotos.
enhanceFace	boolean	optional	false	Wendet zusätzliche Schärfung auf das hochskalierte Ergebnis an.
sharpen	boolean	optional	false	Ausgabeformat. Akzeptiert jpeg oder png.
output	string	optional	jpeg	Output format. Accepts jpeg or png.

03 — Integration

Wie integriere ich die Hochskalierungs-API?

Erstellen Sie in Ihrem ImgGen-Konto einen API-Schlüssel, hinterlegen Sie ihn als Umgebungsvariable und rufen Sie den Endpunkt auf. Hier ist dieselbe Anfrage in cURL, Node.js und Python.

curl --request POST \
  --url 'https://app.imggen.ai/v1/upscale-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form factor=4 \
  --form enhanceFace=false \
  --form sharpen=false \
  --form output=jpeg

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');

const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
  body: form,
});

const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));

import base64, os, requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://app.imggen.ai/v1/upscale-image",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — Antwort

Antwort

Ein erfolgreicher Aufruf gibt JSON zurück. Das Ergebnis ist base64-kodiert — dekodieren Sie es, bevor Sie es auf die Platte oder in Ihren Objektspeicher schreiben. Jede erfolgreiche Antwort trägt außerdem einen X-Credit-Remaining-Header mit Ihrem Guthaben nach dem Aufruf.

{
  "success": true,
  "message": "Image upscaled successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — Limits

Limits und Verhalten, das Sie kennen sollten

Der Endpunkt akzeptiert JPEG (JPG), PNG und WebP mit maximal 25 MB Dateigröße und antwortet synchron innerhalb von 60 Sekunden — es gibt keinen Job abzufragen und keinen Webhook einzurichten.

Wählen Sie Ihr Ausgabeformat

Setzen Sie output=png, wenn Sie verlustfreie Ergebnisse brauchen oder ein Alphakanal erhalten bleiben soll; jpeg hält die Antworten für Katalogarbeit in großem Volumen klein.

Gesichtsverbesserung ist optional

enhanceFace führt zusätzliche Gesichtsrekonstruktion aus, um Porträts zu verbessern und hochzuskalieren. Lassen Sie es bei Produktaufnahmen und Landschaften aus, wo es kein Gesicht zu verbessern gibt.

Synchronous by design

There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.

06 — Im Einsatz

Wofür wird die Hochskalierungs-API eingesetzt?

Wo Teams diesen Endpunkt produktiv einsetzen, um Bilder programmatisch und in großem Umfang zu verarbeiten.

Migration alter Kataloge

Bringen Sie jahrelang gewachsene, kleine Produktbilder in niedriger Auflösung per Stapelverarbeitung auf heutige Darstellungsstandards, statt sie neu zu fotografieren.

Druckvorbereitung

Heben Sie Web-Assets auf eine Größe, die im Druck standhält, mit optionaler Schärfung im selben Aufruf für ein präziseres Ergebnis.

Nutzergenerierte Inhalte

Skalieren Sie kleine Avatare und Uploads serverseitig hoch, damit sie auf hochauflösenden Displays sauber aussehen.

Medien und Archive

Erhöhen Sie die Auflösung gescannter oder komprimierter Quellbilder, bevor sie in ein Content-Management-System wandern — bei Bedarf zusammen mit der Restaurierung.

07 — Kosten

Was kostet die Hochskalierungs-API?

Jeder erfolgreiche Aufruf kostet 2–4 Credits, Ihre effektiven Kosten pro Bild richten sich also nach Ihrem Tarif. Die Credits stammen aus Ihrem Tarif und gelten für alle Endpunkte und den Web-Editor gemeinsam — Sie kaufen kein getrenntes Kontingent pro Tool. Ein fehlgeschlagener Aufruf wird automatisch erstattet. Alle Details auf der Preisseite.

ImgGen AI Tarife und API-Zugang
Tarif	Preis	Credits	API
Free	$0	50 einmalige Gratis-Credits	Kein API-Zugang
Starter	$9.99 / month	400 Credits / Monat	API-Zugang enthalten
Pro	$29.99 / month	1.400 Credits / Monat	API-Zugang + priorisierter Support
Enterprise	Custom	Individuelles Volumen	Dedizierte Infrastruktur

Credit-Kosten und Limits zuletzt geprüft am 2026-08-27.

08 — Verwandt

Teams, die die Hochskalierungs-API nutzen, greifen als Nächstes meist zu diesen.

→Fotorestaurierungs-API →Kolorierungs-API AI Image Upscaler (Web-Tool)Alle API-Endpunkte

Ebenfalls verfügbar: Hintergrundentfernung, Wasserzeichenentfernung, Textentfernung, Bildgenerierung.

FAQ

FAQ zur Hochskalierungs-API

: Es ist ein HTTP-Endpunkt, der die Auflösung eines Bildes mit einem trainierten Modell erhöht. Statt wie beim Skalieren zwischen vorhandenen Pixeln zu interpolieren, sagt das Modell die Details voraus, die eine höher aufgelöste Fassung des Bildes enthalten würde — Kanten, Textur und Struktur — und rekonstruiert sie. Sie senden das Bild per POST und lesen das vergrößerte Ergebnis aus der Antwort.
: Der Parameter factor akzeptiert 2 oder 4 und steht standardmäßig auf 4. Die Eingabe kann JPEG (JPG), PNG und WebP bis 25 MB sein, die Ausgabe wird als jpeg (Standard) oder png zurückgegeben.
: Die Kosten folgen dem Faktor: 2 Credits bei factor=2 und 4 Credits bei factor=4 (dem Standard). Starter gibt Ihnen 400 Credits im Monat für 9,99 $ und Pro 1.400 für 29,99 $, und nicht genutzte Credits werden übertragen, solange Sie abonniert bleiben. Abrechnung über Credits heißt: Ein Monat mit viel Volumen und ein ruhiger Monat kosten Sie pro Bild dasselbe.
: Die Hochskalierung rekonstruiert beim Vergrößern Details, was weiche Bilder nebenbei schärft, und das sharpen-Flag treibt das weiter. Für beschädigte oder verblasste Fotografien — Kratzer, Risse, Farbverlust — nehmen Sie stattdessen die Fotorestaurierungs-API, die auf Reparatur statt auf Auflösung ausgelegt ist.
: Synchron. Es gibt keine Job-ID abzufragen und keinen Webhook einzurichten — das hochskalierte Bild steckt im Body derselben Antwort, mit einer Obergrenze von 60 Sekunden pro Anfrage.
: Ja. Alle Tarife, auch der kostenlose, enthalten vollständige kommerzielle Nutzungsrechte, und kein Ergebnis trägt ein Wasserzeichen. Sie dürfen alles, was die API zurückgibt, verkaufen, drucken oder veröffentlichen.
: Nein. Die API ist zustandslos: Sie legt kein Projekt an, speichert keine Datei und behält Ihr Bild nicht. Ihr Upload wird in ein temporäres Objekt geschrieben, verarbeitet und gelöscht, sobald die Antwort zurückgegeben wurde. Erhalten bleibt nur ein Nutzungsprotokoll, das festhält, dass ein Aufruf stattgefunden hat und wie viele Credits er gekostet hat. Ihre Bilder werden nie zum Trainieren von Modellen verwendet.

Loslegen

Rufen Sie die Hochskalierungs-API auf

Ein Schlüssel schaltet alle sieben Endpunkte frei. Kein Wasserzeichen, vollständige kommerzielle Rechte, und nichts von dem, was Sie senden, wird nach der Antwort gespeichert.

API-Schlüssel holen