ab 3 Credits pro Aufruf
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.
- REST · JSON
- Kein Wasserzeichen
- Nichts wird gespeichert
POST /v1/generate-image
Was ist die KI-Bildgenerierungs-API?
Die ImgGen AI Bildgenerierungs-API ist ein REST-Endpunkt, der einen Text-Prompt in Bilder verwandelt. Sie senden einen JSON-Body mit dem Prompt, der gewünschten Anzahl Samples, einem Seitenverhältnis und dem zu verwendenden Modell; der Endpunkt gibt die erzeugten Bilder base64-kodiert in einem Array zurück. Er ist der einzige Endpunkt, der JSON statt einer Datei entgegennimmt.
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 Generator an.
Anfrageparameter
Senden Sie eine POST-Anfrage an https://app.imggen.ai/v1/generate-image, authentifiziert mit einem API-Schlüssel im Authorization-Header.
| Parameter | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| prompt | string | PFLICHT | — | Textbeschreibung des zu erzeugenden Bildes. |
| samples | number | optional | 1 | Wie viele Bilder erzeugt werden sollen, von 1 bis 4. |
| aspect_ratio | string | optional | square | Ausgabeform. Akzeptiert square, portrait oder landscape. |
| model | string | optional | imggen-base | Generierungsmodell. Akzeptiert imggen-base, imggen-base-fast oder imggen-xl. |
Wie integriere ich die KI-Bildgenerierungs-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/generate-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))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": "Images generated successfully",
"images": ["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.
Gibt ein images-Array zurück
Anders als die Bearbeitungs-Endpunkte, die ein einzelnes image-Feld zurückgeben, liefert die Generierung images — ein Array mit einem Eintrag pro angefordertem Sample.
Drei Modelle
imggen-base ist die Standardbalance, imggen-base-fast tauscht Detail gegen Tempo, und imggen-xl zielt auf die höchste Qualität. Die Wahl treffen Sie pro Anfrage, nicht pro Konto.
JSON statt Multipart
Dies ist der einzige Endpunkt, der einen JSON-Body entgegennimmt. Senden Sie Content-Type: application/json statt eines Multipart-Formulars.
Wofür wird die KI-Bildgenerierungs-API eingesetzt?
Wo Teams diesen Endpunkt produktiv einsetzen, um Bilder programmatisch und in großem Umfang zu verarbeiten.
Redaktions- und Blogbilder
Erzeugen Sie zu jedem Artikel aus der Überschrift ein eigenes Aufmacherbild, statt aus einer Stockbibliothek zu greifen, die alle anderen auch nutzen.
Produkt- und Kampagnenkonzeption
Erzeugen Sie vier Varianten einer visuellen Idee in einem Aufruf, damit ein Team eine Richtung wählen kann, bevor die eigentliche Arbeit beauftragt wird.
Kreativfunktionen in der App
Lassen Sie Ihre Nutzerinnen und Nutzer Bilder in Ihrem Produkt erzeugen, ohne dass Sie GPU-Infrastruktur aufbauen müssen.
Platzhalter- und Demo-Inhalte
Füllen Sie Demos, Prototypen und Testumgebungen mit glaubwürdigen, auf Abruf erzeugten Bildern.
Was kostet die KI-Bildgenerierungs-API?
Jeder erfolgreiche Aufruf kostet ab 3 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 KI-Bildgenerierungs-API nutzen, greifen als Nächstes meist zu diesen.
Ebenfalls verfügbar: Wasserzeichenentfernung, Textentfernung, Fotorestaurierung, Fotokolorierung.
FAQ zur KI-Bildgenerierungs-API
- Es ist ein HTTP-Endpunkt, der eine geschriebene Beschreibung in ein Bild verwandelt. Sie senden einen Prompt als JSON, und der Dienst gibt die erzeugten Bilder in der Antwort zurück — damit kann ein Produkt Text-zu-Bild anbieten, ohne eigene Modellinfrastruktur zu betreiben.
- Zwischen einem und vier, gesteuert über den Parameter samples. Alle angeforderten Bilder kommen in einem einzigen images-Array derselben Antwort zurück.
- Drei: imggen-base ist der Standard und balanciert Qualität gegen Tempo, imggen-base-fast liefert schneller mit weniger Detail, und imggen-xl zielt auf die höchste Qualität. Sie wählen pro Anfrage über den Parameter model.
- square, portrait und landscape, gesetzt über aspect_ratio. Lassen Sie es weg, gilt standardmäßig square.
- Die Generierung wird pro Modell statt zu einem Pauschalpreis berechnet, weil sich die Modelle im Rechenaufwand deutlich unterscheiden. Sie beginnt bei 3 Credits pro Bild im Standardmodell und steigt bei den hochwertigeren. Ihr Restguthaben kommt im Header X-Credit-Remaining jedes erfolgreichen Aufrufs zurück, und die aktuellen Kosten je Modell sehen Sie in Ihrem ImgGen-Konto.
- Ihnen. ImgGen erhebt keinen Eigentumsanspruch auf das, was die API zurückgibt, und jeder Tarif bringt volle kommerzielle Nutzungsrechte ohne Wasserzeichen mit. Bedenken Sie, dass das Urheberrecht an KI-erzeugten Bildern je nach Rechtsordnung unterschiedlich behandelt wird — wenn Eigentum für Ihren Fall rechtlich tragend ist, prüfen Sie die Lage vor Ort.
- 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.
- Erzeugte Bilder werden in der Antwort zurückgegeben und nicht aufbewahrt. Wie bei jedem ImgGen-Endpunkt bleibt nur ein Nutzungsprotokoll erhalten, das festhält, dass ein Aufruf stattfand und was er gekostet hat. Ihre Inhalte werden nicht zum Trainieren von Modellen verwendet.
Loslegen
Rufen Sie die KI-Bildgenerierungs-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