2 Credits pro Aufruf
Kolorierungs-API
Verwandeln Sie Schwarz-Weiß-Fotografien mit einer Anfrage in natürlich kolorierte Bilder. Optionale Rissreparatur im selben Aufruf — und an keiner Stelle manuelle Farbwahl.
- REST · JSON
- Kein Wasserzeichen
- Nichts wird gespeichert
POST /v1/colorize-photo
Was ist die Kolorierungs-API?
Die ImgGen AI Kolorierungs-API ist ein REST-Endpunkt, der Schwarz-Weiß- oder Graustufenbildern realistische Farbe hinzufügt. Das Modell leitet plausible Farben für Haut, Kleidung, Vegetation, Himmel und Materialien aus dem Bildinhalt selbst ab — eine Referenzpalette oder manuelle Auswahl ist nicht nötig. Das kolorierte Ergebnis kommt in derselben 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 Colorize Photo an.
Anfrageparameter
Senden Sie eine POST-Anfrage an https://app.imggen.ai/v1/colorize-photo, authentifiziert mit einem API-Schlüssel im Authorization-Header.
| Parameter | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| image | file | PFLICHT | — | Repariert Kratzer und Risse während der Kolorierung. |
| removeTears | boolean | optional | false | Repair scratches and tears while colorizing. |
Wie integriere ich die API zum Kolorieren von Fotos?
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/colorize-photo' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form removeTears=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');
const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
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/colorize-photo",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"removeTears": "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 colorized 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.
Farbe wird abgeleitet, nicht wiederhergestellt
Das Modell sagt plausible Farbe aus dem Bildinhalt voraus. Es erzeugt eine überzeugende Interpretation, keine historisch belegte — das sollte man offen sagen, wenn Sie Ergebnisse Ihren Nutzerinnen und Nutzern zeigen.
Reparieren beim Kolorieren
Setzen Sie removeTears=true, um Kratzer und physische Schäden im selben Durchgang zu beheben, ohne zweiten Aufruf des Restaurierungs-Endpunkts.
Bereits farbige Bilder
Der Endpunkt ist für Graustufen-Eingaben gebaut. Ein Bild zu senden, das bereits Farbe hat, bringt nichts — nehmen Sie den Restaurierungs-Endpunkt, wenn es ums Reparieren geht.
Wofür wird die API zum Kolorieren von Fotos eingesetzt?
Wo Teams diesen Endpunkt produktiv einsetzen, um Bilder programmatisch und in großem Umfang zu verarbeiten.
Produkte rund um Familiengeschichte
Lassen Sie Nutzerinnen und Nutzer geerbte Fotografien in Ihrer App kolorieren — als kostenpflichtiges Upgrade oder Engagement-Feature.
Redaktion und Publishing
Erzeugen Sie kolorierte Fassungen von Archivfotografien für Reportagen und Rückblicke, klar als Interpretationen gekennzeichnet.
Massenverarbeitung von Archiven
Erzeugen Sie farbige Nutzungskopien über eine ganze Graustufen-Sammlung hinweg, während die Originale unberührt bleiben.
Gedenk- und Geschenkdienste
Kolorieren und reparieren Sie die hochgeladene Fotografie eines Kunden automatisch als Teil der Bestellstrecke.
Was kostet die API zum Kolorieren von Fotos?
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 API zum Kolorieren von Fotos nutzen, greifen als Nächstes meist zu diesen.
Ebenfalls verfügbar: Hintergrundentfernung, Wasserzeichenentfernung, Textentfernung, Bildgenerierung.
FAQ zur Kolorierungs-API
- Es ist ein HTTP-Endpunkt, der ein Schwarz-Weiß-Bild entgegennimmt und eine kolorierte Fassung zurückgibt. Das Modell liest den Inhalt der Fotografie — Gesichter, Kleidung, Vegetation, Himmel, Materialien — und sagt passende Farben voraus, sodass Sie ein natürliches Ergebnis ohne Palettenangabe bekommen.
- Sie sind plausibel, nicht belegt. Das Modell weiß nicht, welche Farbe eine bestimmte Jacke 1953 tatsächlich hatte; es erzeugt die wahrscheinlichste Kolorierung angesichts von allem, was im Bild sichtbar ist. Hauttöne, Vegetation und Himmel überzeugen meist, weil sie in einem engen Bereich variieren; Kleidung, lackierte Oberflächen und andere Objekte mit beliebiger Farbe sind fundierte Vermutungen. Präsentieren Sie das Ergebnis bei historischem Material als Interpretation.
- Zwei Credits pro erfolgreichem Aufruf. 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 Ihr Abo aktiv ist.
- Erzeugen Sie in Ihrem ImgGen-Konto einen API-Schlüssel und senden Sie dann per POST ein Multipart-Formular mit einem image-Feld an https://app.imggen.ai/v1/colorize-photo, authentifiziert über einen Authorization: Bearer-Header. Dekodieren Sie das base64-Feld image aus der JSON-Antwort und legen Sie es dort ab, wo Sie Ihre Assets speichern. Beispiele in cURL, Node.js und Python finden Sie auf dieser Seite.
- Dieser Endpunkt ist aufs Hinzufügen von Farbe ausgelegt und kann optional Risse reparieren. Der Restaurierungs-Endpunkt ist aufs Reparieren von Schäden ausgelegt und kann optional Farbe hinzufügen. Ist die Fotografie vor allem beschädigt, nehmen Sie die Restaurierung; ist sie vor allem einfach schwarz-weiß, nehmen Sie diesen hier.
- 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.
Loslegen
Rufen Sie die Kolorierungs-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