v1 · 7 Endpunkte · live
Bildbearbeitung
API für Entwickler
Sieben KI-Endpunkte zur Bildverarbeitung hinter einem einzigen API-Schlüssel: Hintergrundentfernung, Hochskalierung, Wasserzeichen- und Textentfernung, Restaurierung, Kolorierung und Text-zu-Bild. Schlichtes REST, eine JSON-Antwort und nichts gespeichert, sobald der Aufruf durch ist.
- 7 Endpunkte, 1 Schlüssel
- REST über HTTPS
- Kein Wasserzeichen
- Nichts wird gespeichert
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}Was ist die ImgGen AI Bildbearbeitungs-API?
Die ImgGen AI Bildbearbeitungs-API ist ein REST-Dienst, der KI-Bildverarbeitung auf Abruf ausführt. Sie senden ein Bild — oder einen Text-Prompt — per HTTPS an einen Endpunkt, und das verarbeitete Ergebnis kommt base64-kodiert in der JSON-Antwort zurück. Es gibt kein Modell zu hosten und keine GPU bereitzustellen.
Alle Endpunkte teilen dieselbe Basis-URL, denselben API-Schlüssel und dasselbe Antwortformat. Eine zweite Fähigkeit in Ihren Workflow aufzunehmen ist damit ein Pfadwechsel und keine neue Integration. Wenn Sie die Modelle testen möchten, bevor Sie Code schreiben: Dieselben Modelle treiben die kostenlosen ImgGen AI Tools im Browser an.
Wie nutze ich die Bildbearbeitungs-API?
Erzeugen Sie einen API-Schlüssel und senden Sie dann eine Multipart-Anfrage mit Ihrem Bild. Dieses Beispiel entfernt einen Hintergrund; alle anderen Bearbeitungs-Endpunkte folgen demselben Muster mit einem anderen Pfad. Die Bildgenerierung ist die einzige Ausnahme — sie nimmt statt einer Datei einen JSON-Body mit Ihrem Prompt, der Anzahl der Samples und dem Seitenverhältnis entgegen.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))Die sieben Endpunkte
Jeder hat seine eigene Referenzseite mit Parametern, Codebeispielen in drei Sprachen und den genauen Credit-Kosten.
Hintergrundentfernungs-API
Entfernen Sie Bildhintergründe programmatisch mit einer einzigen POST-Anfrage. Ein API-Schlüssel, transparentes PNG als Ausgabe und ein zustandsloser Dienst, der die gesendeten Bilder nie speichert.
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.
Wasserzeichen-Entfernungs-API
Erkennen und löschen Sie Wasserzeichen in einer einzigen Anfrage. Generatives Inpainting rekonstruiert die Pixel hinter der Marke — und dies ist der einzige Endpunkt, der auch einen Stapel von Bildern annimmt.
Textentfernungs-API
Löschen Sie Beschriftungen, Einblendungen, Zeitstempel und eingebrannte Labels programmatisch aus Bildern. Die Erkennung läuft automatisch — und wenn im Bild kein Text ist, wird Ihnen nichts berechnet.
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.
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.
KI-Bildgenerierungs-API
Erzeugen Sie Bilder aus einem Text-Prompt mit einer einzigen JSON-Anfrage. Bis zu vier Samples pro Aufruf, drei Modelle für den Kompromiss zwischen Tempo und Qualität, und volle kommerzielle Rechte am Ergebnis.
Was kostet die Bildbearbeitungs-API?
Die Abrechnung erfolgt über Credits statt über eine Pauschale pro Aufruf — ein intensiver und ein ruhiger Monat kosten pro Bild also dasselbe. Credits gelten für alle Endpunkte und den Web-Editor gemeinsam: ein Guthaben, kein getrenntes Kontingent pro Tool. Ein fehlgeschlagener Aufruf wird automatisch erstattet, und jede erfolgreiche Antwort liefert Ihr Restguthaben im Header X-Credit-Remaining zurück.
| Endpunkt | Pfad | Credits / Aufruf |
|---|---|---|
| Hintergrundentfernung | /v1/remove-background | 1 |
| Hochskalierung | /v1/upscale-image | 2–4 |
| Wasserzeichenentfernung | /v1/remove-watermark | 2 |
| Textentfernung | /v1/remove-text | 2 |
| Fotorestaurierung | /v1/image-restoration | 2 |
| Fotokolorierung | /v1/colorize-photo | 2 |
| Bildgenerierung | /v1/generate-image | 3+ |
| Tarif | Preis | Credits | API | Hinweise |
|---|---|---|---|---|
| Free | $0 | 50 einmalige Gratis-Credits | Kein API-Zugang | Keine Kreditkarte nötig |
| Starter | $9.99 / month | 400 Credits / Monat | API-Zugang enthalten | Nicht genutzte Credits werden übertragen |
| Pro | $29.99 / month | 1.400 Credits / Monat | API-Zugang + priorisierter Support | Nicht genutzte Credits werden übertragen |
| Enterprise | Custom | Individuelles Volumen | Dedizierte Infrastruktur | support@imggen.ai |
Credit-Kosten und Limits zuletzt geprüft am 2026-08-27. Alle Details auf der Preisseite.
Wie die API arbeitet
Bewusst unspektakulär: eine Anfrage, eine Antwort, keine Orchestrierung auf Ihrer Seite.
Synchron, keine Warteschlange
Das verarbeitete Bild steckt im Body derselben Antwort. Keine Job-ID abzufragen, kein Webhook-Endpunkt aufzusetzen, keine Warteschlange abzugleichen. Für Anfragen gilt eine Obergrenze von 60 Sekunden.
Multipart rein, base64 raus
Senden Sie Ihr Eingabebild als Multipart-Formular — JPEG (JPG), PNG und WebP, bis 25 MB. Das Ergebnis kommt base64-kodiert im JSON-Body zurück: dekodieren und dort ablegen, wo Sie Ihre Assets speichern.
Nur bei Erfolg berechnet
Credits werden atomar abgebucht und automatisch erstattet, wenn die Verarbeitung fehlschlägt — berechnet werden Ihnen also nur Bilder, die tatsächlich zurückkommen. Die Textentfernung gibt sogar kostenfrei 422 zurück, wenn es keinen Text zu entfernen gibt.
Schlüssel, die Sie rotieren können
Schlüssel werden nur einmal angezeigt und ausschließlich als Hash gespeichert. Ein Widerruf greift in etwa einer Minute — ein geleakter Schlüssel ist damit ein Ein-Minuten-Problem und kein Vorfall.
Speichert die API meine Bilder oder trainiert damit?
Nein. Die API ist zustandslos. Anders als der Web-Editor, der Ihre Projekte speichert, damit Sie darauf zurückkommen können, legt ein API-Aufruf kein Projekt, keinen Task-Eintrag und keine gespeicherte Datei an. 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. Das zählt, wenn Sie Kundenfotos verarbeiten, die Sie vertraglich nicht aufbewahren dürfen — es ist die Architektur und nicht bloß die Richtlinie, die sie aus unserem Speicher heraushält.
Fehlerantworten
Fehlschläge geben einen JSON-Umschlag der Form { "error": { "message", "code" } } zurück, wobei der HTTP-Status zum Code passt.
| Status | Code | Bedeutung |
|---|---|---|
| 401 | UNAUTHORIZED | Der API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. |
| 402 | INSUFFICIENT_CREDITS | Ihr Konto hat nicht genug Credits für diesen Aufruf. |
| 403 | FORBIDDEN | Ihr Tarif gewährt keinen Zugriff auf dieses Tool. |
| 404 | NOT_FOUND | Der Endpunkt-Pfad existiert nicht. |
| 409 | CONFLICT | Die Anfrage steht im Konflikt mit dem aktuellen Zustand der Ressource. |
| 422 | VALIDATION_ERROR | Die Anfrage wurde abgelehnt — ein ungültiger Dateityp, ein fehlendes Feld oder nichts zu verarbeiten. Es werden keine Credits berechnet. |
Wer nutzt die ImgGen API?
Wo sich eine API zur Bildverarbeitung in einem Produkt bezahlt macht.
E-Commerce und Marktplätze
Vereinheitlichen Sie Lieferanten- und Verkäuferbilder schon beim Upload — Hintergründe freistellen, eingeblendeten Text entfernen und kleine Altbestände hochskalieren, damit jedes Angebot wirkt, als käme es aus demselben Studio.
Print-on-Demand und Produkt-Mockups
Motive freistellen, auf Druckauflösung hochskalieren und auf Vorlagen montieren, ohne dass ein Designer jede Bestellung anfassen muss.
Design- und Editor-SaaS
Bringen Sie Ein-Klick-Bearbeitung in Ihr eigenes Produkt, ohne GPUs zu hosten, Modelle zu finetunen oder einen Inferenz-Stack zu betreiben.
Archive, Ahnenforschung und Digitalisierung
Reparieren, kolorieren und vergrößern Sie gescannte Fotografien in einer automatisierten Pipeline, statt jedes Bild von Hand zu retuschieren.
Content- und Publishing-Plattformen
Erzeugen Sie eigene Bilder aus einem Prompt und säubern Sie Uploads Ihrer Autorinnen und Autoren als Teil Ihres bestehenden redaktionellen Workflows.
Agenturen und interne Tools
Automatisieren Sie die repetitive Bildarbeit zwischen Kundenbriefing und fertigem Asset — direkt aus den Tools, die Ihr Team ohnehin nutzt.
FAQ zur Bildbearbeitungs-API
- Ja. Die ImgGen AI Bildbearbeitungs-API stellt sieben REST-Endpunkte bereit — Hintergrundentfernung, Hochskalierung, Wasserzeichenentfernung, Textentfernung, Fotorestaurierung, Kolorierung und Text-zu-Bild-Generierung — alle unter https://app.imggen.ai und alle mit einem einzigen API-Schlüssel erreichbar.
- Sie führt eine bestimmte Bearbeitung an dem Bild aus, das Sie senden, und gibt das Ergebnis in derselben Antwort zurück. Sie können einen Hintergrund zu einem transparenten PNG entfernen, um 2x oder 4x hochskalieren, Wasserzeichen oder eingebrannten Text löschen, beschädigte Fotografien reparieren und kolorieren sowie neue Bilder aus einem Text-Prompt erzeugen.
- Legen Sie unter https://editor.imggen.ai ein ImgGen-Konto an und erzeugen Sie in den Kontoeinstellungen einen Schlüssel. Der Schlüssel wird nur einmal angezeigt und ausschließlich als Hash gespeichert — kopieren Sie ihn also an einen sicheren Ort: Geht er verloren, erzeugen Sie einen neuen, statt den alten wiederherzustellen. Ein Widerruf greift innerhalb von etwa einer Minute.
- Senden Sie Ihren Schlüssel als Bearer-Token: Authorization: Bearer sk_live_… bei jeder Anfrage. Schlüssel, die vor dem aktuellen Schema ausgegeben wurden, können sich auch über den älteren Header x-imggen-key authentifizieren, der weiterhin akzeptiert wird.
- Die Nutzung wird in Credits gemessen statt über eine Pauschale pro Aufruf, und die Kosten hängen vom Endpunkt ab: Hintergrundentfernung kostet 1 Credit; Wasserzeichenentfernung, Textentfernung, Restaurierung und Kolorierung kosten 2; Hochskalierung kostet 2 bei factor=2 und 4 bei factor=4; die Bildgenerierung beginnt bei 3 und variiert je nach Modell. Starter gibt Ihnen 400 Credits pro Monat für 9,99 $ und Pro 1.400 für 29,99 $, wobei nicht genutzte Credits übertragen werden, solange Ihr Abo aktiv ist.
- Ein kostenloses ImgGen-Konto enthält 50 Credits ohne Kreditkarte — genug, um die Modelle in den Web-Tools zu bewerten. Der API-Zugang selbst gehört zu den kostenpflichtigen Tarifen Starter und Pro. Eine dauerhaft kostenlose API-Stufe gibt es nicht, und wir sagen das lieber offen, als eine anzukündigen, die dann still gedrosselt wird.
- 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.
- Synchron. Es gibt keine Job-ID abzufragen, keine Warteschlange zu verwalten und keinen Webhook einzurichten — das verarbeitete Bild steckt im Body derselben Antwort. Für Anfragen gilt eine Obergrenze von 60 Sekunden.
- 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.
- Der Endpunkt zur Wasserzeichenentfernung akzeptiert einen Stapel von Dateien unter image[] und gibt ein images-Array zurück. Alle anderen Endpunkte verarbeiten ein Bild pro Anfrage — für Volumen schicken Sie die Anfragen parallel aus Ihrem eigenen Worker, da jeder Aufruf unabhängig ist.
- Derzeit nicht. Die API ist schlichtes REST über HTTPS mit Multipart-Uploads, jeder HTTP-Client funktioniert also, und die Dokumentation liefert kopierfertige Beispiele in cURL, Node.js und Python. Eine offizielle Client-Bibliothek und eine veröffentlichte OpenAPI-Spezifikation gibt es bislang nicht.
Loslegen
Der erste Aufruf steht in fünf Minuten
Schlüssel erzeugen, das cURL-Beispiel kopieren — und die Hintergrundentfernung läuft. Ein Schlüssel deckt alle sieben Endpunkte ab, in jedem Tarif mit API-Zugang.
API-Schlüssel holen