2 Credits pro Aufruf
Fotorestaurierungs-API
Reparieren Sie alte, beschädigte und verblasste Fotografien aus Ihrem eigenen Backend. Kolorieren und Auflösung erhöhen optional in derselben Anfrage, statt drei Aufrufe zu verketten.
- REST · JSON
- Kein Wasserzeichen
- Nichts wird gespeichert
POST /v1/image-restoration
Was ist die Fotorestaurierungs-API?
Die ImgGen AI Fotorestaurierungs-API ist ein REST-Endpunkt, der beschädigte Fotografien repariert. Sie mindert Kratzer, Risse, Flecken, Verblassen und Unschärfe und kann optional einer Schwarz-Weiß-Vorlage Farbe hinzufügen und ihre Auflösung im selben Aufruf erhöhen. Sie laden den Scan hoch, und das restaurierte Bild kommt in der Antwort 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 Image Restoration an.
Anfrageparameter
Senden Sie eine POST-Anfrage an https://app.imggen.ai/v1/image-restoration, authentifiziert mit einem API-Schlüssel im Authorization-Header.
| Parameter | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| image | file | PFLICHT | — | Fügt einer Schwarz-Weiß-Fotografie beim Restaurieren realistische Farbe hinzu. |
| colorize | boolean | optional | false | Repariert Kratzer, Risse und physische Schäden. |
| removeTears | boolean | optional | false | Skaliert das restaurierte Bild für zusätzliche Auflösung hoch. Rechnet die Kosten des Hochskalierers auf den Aufruf. |
| enhanceResolution | boolean | optional | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
Wie integriere ich die Fotorestaurierungs-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/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))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 restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}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.
Drei Operationen, ein Aufruf
Reparieren, Kolorieren und Hochskalieren sind Flags derselben Anfrage statt getrennter Endpunkte — eine vollständige Restaurierung ist also ein Roundtrip statt drei.
enhanceResolution kostet extra
enhanceResolution einzuschalten rechnet die Kosten des Hochskalierers auf die Grundgebühr der Restaurierung, weil zusätzlich das Hochskalierungsmodell läuft.
Die Scanqualität zählt
Das Modell rekonstruiert aus dem, was es sehen kann. Ein planer, gleichmäßig ausgeleuchteter Scan in der höchsten Auflösung Ihres Scanners liefert deutlich bessere Ergebnisse als ein Handyfoto eines Abzugs.
Wofür wird die Fotorestaurierungs-API eingesetzt?
Wo Teams diesen Endpunkt produktiv einsetzen, um Bilder programmatisch und in großem Umfang zu verarbeiten.
Ahnenforschungs- und Archivplattformen
Bieten Sie Ein-Klick-Restaurierung für hochgeladene Familienfotos an, ohne ein Restaurierungsmodell zu bauen oder zu hosten.
Digitalisierungsdienste
Lassen Sie die Restaurierung automatisch laufen, während die Scans aus dem Scanner kommen, damit Ihre Leute Ergebnisse prüfen statt jedes Bild zu bearbeiten.
Museums- und Bibliotheksbestände
Erzeugen Sie vorzeigbare Nutzungskopien von beschädigtem fotografischem Material, während die Originale unberührt bleiben.
Fotodruck-Produkte
Reparieren und skalieren Sie die hochgeladene Fotografie eines Kunden in einem Aufruf, bevor sie in den Druck geht.
Was kostet die Fotorestaurierungs-API?
Jeder erfolgreiche Aufruf kostet 2 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.
| 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.
Verwandte Endpunkte und Tools
Teams, die die Fotorestaurierungs-API nutzen, greifen als Nächstes meist zu diesen.
Ebenfalls verfügbar: Hintergrundentfernung, Wasserzeichenentfernung, Textentfernung, Bildgenerierung.
FAQ zur Fotorestaurierungs-API
- Es ist ein HTTP-Endpunkt, der beschädigte Fotografien automatisch repariert. Er mindert Kratzer, Risse, Flecken, Verblassen und Unschärfe und kann das Ergebnis optional kolorieren und vergrößern. Er existiert, damit ein Produkt seinen Nutzerinnen und Nutzern Restaurierung anbieten kann, ohne dass jemand von Hand retuschiert.
- Ja. Setzen Sie colorize=true, und das Modell fügt im selben Restaurierungsdurchgang realistische Farbe hinzu. Wenn Sie nur Farbe brauchen und die Fotografie nicht beschädigt ist, ist der eigene Kolorierungs-Endpunkt die günstigere, direktere Wahl.
- Zwei Credits pro erfolgreichem Aufruf. enhanceResolution=true rechnet die Kosten des Hochskalierers obendrauf, weil ein zweites Modell läuft. Starter enthält 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.
- Kratzer, Risse, Flecken, Wasserschäden, Farbverlust, Vergilbung und allgemeine Unschärfe. Setzen Sie removeTears=true speziell für physische Schäden. Bereiche, in denen der ursprüngliche Bildinhalt vollständig fehlt, werden plausibel rekonstruiert und nicht wiederhergestellt — das Modell schlussfolgert, es macht nichts rückgängig.
- Das kann passieren, und es lohnt sich, das zu verstehen, bevor Sie es Ihren Nutzerinnen und Nutzern vorsetzen. Das Modell rekonstruiert fehlende Information durch Schlussfolgerung — ein stark beschädigtes oder sehr niedrig aufgelöstes Gesicht kann also subtil anders zurückkommen als die Person im Original. Es arbeitet mit dem, was sichtbar ist; wo nichts sichtbar ist, erzeugt es eine plausible Vermutung. Behandeln Sie das Ergebnis als restaurierte Interpretation, nicht als wiederhergestelltes Original.
- Eine Fotografie pro Anfrage. Dieser Endpunkt hat keine Stapelform — nur die Wasserzeichenentfernung unterstützt image[]. Für ein ganzes Archiv schicken Sie die Anfragen parallel aus Ihrem eigenen Worker; jede ist unabhängig und wird einzeln berechnet.
- Die API akzeptiert JPEG- (JPG), PNG- und WebP-Dateien bis 25 MB pro Bild. Die Ergebnisse werden als base64-kodiertes Bild in der JSON-Antwort zurückgegeben.
- 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.
- 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.
Loslegen
Rufen Sie die Fotorestaurierungs-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