GeraikitaGeraikita AI
MenüBildgenerierung

Bildgenerierung

Verwandle eine Textbeschreibung (Prompt) in Bilder mit Bildmodellen von Google (Familie Nano Banana / Gemini Image). Der Endpoint ist kompatibel mit der OpenAI Images API — richte das openai-SDK einfach auf die Geraikita-Base-URL, mit demselben gk-Key und demselben GeraiPoints-Guthaben.

Endpoint

POSThttps://ai.geraikita.com/v1/images/generations
HeaderWert
AuthorizationBearer gk-... (oder x-api-key: gk-...)
Content-Typeapplication/json

Eine Anfrage = ein Prompt, ergibt 1–4 Bilder. Streaming wird nicht unterstützt — die Antwort kommt in einem Stück, sobald die Bilder fertig sind.

Body-Parameter

ParameterTypBeschreibung
modelstringPflichtID des Bildmodells, z. B. gemini-3.1-flash-image oder gemini-3-pro-image — die vollständige Liste steht in der Preistabelle unten.
promptstringPflichtBeschreibung des gewünschten Bildes, höchstens 4000 Zeichen.
nintegeroptionalAnzahl der Bilder, 1–4. Standard 1. Jedes erfolgreiche Bild wird einzeln abgerechnet.
sizestringoptionalEiner der Werte auto | 1024x1024 | 1536x1024 | 1024x1536 | 1792x1024 | 1024x1792. Standard auto: das Modell wählt das Seitenverhältnis, meist Querformat 16:9 (etwa 1376×768). Die Größe ist nur ein Hinweis auf das Seitenverhältnis — die endgültige Auflösung bestimmt das Modell.
response_formatstringoptionalurl (Standard) für einen Bildlink oder b64_json für Base64-Bilddaten direkt in der Antwort.

Andere Felder (z. B. quality oder style) werden ignoriert.

Beispiele

Die Verarbeitung dauert meist 15–45 Sekunden pro Anfrage und kann bis zu etwa 4 Minuten dauern, wenn die Ausweichroute genutzt wird. Setze ein Client-Timeout von mindestens 300 Sekunden, damit die Anfrage nicht abbricht, bevor die Bilder fertig sind.
curl https://ai.geraikita.com/v1/images/generations \
  --max-time 300 \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "Werbeplakat für einen Eiskaffee mit Palmzucker auf einem Holztisch, warmes Morgenlicht, großer Schriftzug \"20% RABATT\" oben, flacher Illustrationsstil",
    "n": 1,
    "size": "1024x1024"
  }'

Beispielantwort

data enthält ein Objekt pro erfolgreichem Bild — url oder b64_json je nach response_format. Schlagen einige Bilder fehl, kann es weniger Objekte als n geben.

200 OK · application/json
{
  "created": 1793464057,
  "data": [
    { "url": "https://api.geraikita.com/cdn/ai-gambar/2026/11/xxxxxxxxxxxx.jpg" }
  ]
}

Antwort-Header: X-Geraikita-Images = Anzahl erfolgreicher Bilder, X-Geraikita-GP-Charged = für diese Anfrage abgebuchte GeraiPoints.

Preise

Bildmodelle werden pro erfolgreich erzeugtem Bild abgerechnet — nicht pro Token. Aktuelle Preise (Änderungen vorbehalten) stehen in der Tabelle unten und auf der Preisseite.

Modell-IDNamePro Bild
gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image)100 GP / Bild
gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image)100 GP / Bild
  • Fehlgeschlagene Bilder kosten nichts, ebenso abgelehnte Anfragen (ungültige Parameter oder Verstöße gegen die Inhaltsrichtlinie).
  • Dein GeraiPoints-Guthaben muss n × Preis pro Bild abdecken, bevor die Anfrage verarbeitet wird; sonst lautet die Antwort 402.
  • Bildmodelle sind nicht enthalten im Unlimited plan, in Bansos (Free Tier) oder anderen Gratiskontingenten — sie werden immer vom GeraiPoints-Guthaben abgebucht.
  • Jedes Bild erscheint als eine Zeile im Nutzungsverlauf des Dashboards, markiert mit Bild.

Fehlercodes

Fehler folgen dem OpenAI-Format: ein error-Objekt mit message, type, param und code.

Statustype / codeBedeutung
400invalid_request_errorUngültiger Parameter (z. B. n außerhalb 1–4, unbekannte size, leerer oder zu langer Prompt). Keine Kosten.
400content_policy_violationDer Prompt verstößt gegen die Inhaltsrichtlinie (siehe unten). Keine Kosten.
401—API-Key fehlt oder ist ungültig.
402insufficient_quotaNicht genug GeraiPoints für die angeforderte Bildanzahl — bitte aufladen.
403—Dieses Modell ist für den API-Key nicht freigegeben — füge es im Dashboard zur Modellliste des Keys hinzu.
404model_not_foundUnbekanntes Modell oder kein Bildmodell.
429rate_limit_exceededZu viele Anfragen — das Limit liegt bei 10 Anfragen/Minute pro Key. Warte gemäß Header Retry-After.
502image_generation_failedDie Bildgenerierung ist serverseitig fehlgeschlagen. Keine Kosten — bitte erneut versuchen.
Fehlerbeispiel
{
  "error": {
    "message": "...",
    "type": "...",
    "param": "...",
    "code": "..."
  }
}

Ein Aufruf eines Bildmodells über /v1/chat/completions liefert 400 mit Verweis auf diesen Endpoint — nutze /v1/images/generations.

Tipps für Prompts

  • Prompts können auf Deutsch, Englisch, Indonesisch oder in anderen Sprachen geschrieben werden.
  • Das Modell kann Text im Bild darstellen — setze den genauen Text in Anführungszeichen, z. B. Schriftzug "20% RABATT".
  • Beschreibe Motiv, Umgebung, Stil (Foto, flache Illustration, 3D, Aquarell), Licht und Komposition — je genauer, desto passender das Ergebnis.
  • Wähle size passend zum Einsatz: 1024x1024 für Feeds, 1024x1792 für Stories/Hochformat, 1792x1024 für Banner im Querformat.
  • Mehrere Varianten nötig? Nutze n bis 4 in einer Anfrage — denke daran, dass jedes erfolgreiche Bild berechnet wird.

Inhaltsrichtlinie

Folgende Anfragen werden abgelehnt:

  • Sexuelle oder explizite Inhalte.
  • Inhalte, die Kinder ausbeuten oder gefährden.
  • Sadistische Gewalt oder Gore.
  • Reale politische Persönlichkeiten oder reale Personen des öffentlichen Lebens.

Ablehnungen liefern 400 mit dem Code content_policy_violation und werden nicht berechnet.

Bildlinks & Speicherung

Die URL in data[].url ist öffentlich — wer den Link hat, kann das Bild öffnen — und nicht garantiert dauerhaft verfügbar. Lade das Bild direkt nach der Erzeugung herunter und speichere eine Kopie in deinem eigenen Speicher, oder fordere b64_json an, um die Bilddaten direkt in der Antwort zu erhalten.