Ist dies die Gemini-Bild-API von Google?
Nein. Wenn du nach einem Gemini-Bild-Endpunkt gesucht hast, ist der erste Schritt zu klären, wer was betreibt. Gemini ist die Modellfamilie von Google, und Google bietet Bildgenerierung über eigene Entwicklerprodukte an. Egal, was diese Produkte können, du erreichst sie über Google, mit Google-Konten, -Schlüsseln und -Nutzungsbedingungen.
Diese Seite ist etwas anderes. Es ist eine gehostete Text-API, in der ein einzelnes Open-Weight-Modell, betrieben von einem unabhängigen Anbieter, darauf abgestimmt ist, ohne Inhaltsablehnungen für die legale Erwachsenen-Nutzung zu antworten. Es ist kein Wiederverkäufer von Gemini, leitet keine Anfragen an Google weiter und trägt keine Empfehlung von Google oder einem anderen Modellanbieter. Der Domainname erwähnt Bildgenerierung, weil viele Besucher nach Hilfe bei Prompts suchen, nicht weil hier Bilder erzeugt werden.
Was du tatsächlich erhältst
Der Umfang ist bewusst klein gehalten, was die Bewertung in wenigen Minuten einfach macht.
- Protokoll: OpenAI-kompatibel. Jedes OpenAI-SDK oder jeder Client funktioniert, nachdem du zwei Dinge geändert hast: die Basis-URL und den Schlüssel.
- Basis-URL:
https://api.imagegenapi.com/v1 - Modell-ID:
uncensored - Methoden:
POST /v1/chat/completionsundGET /v1/models - Funktionen: Streaming über SSE, Function Calling, JSON-Modus und Durchreiche-Sampling-Parameter (
temperature,top_p,stop,seed, Penalties). - Kontextfenster: 100.000 Token, Prompt plus Vervollständigung.
Nicht enthalten: Bildgenerierung, Bildeingabe, Audio, Video, Embeddings und Fine-Tuning. Wenn eine Funktion nicht in der obigen Liste steht, gehe davon aus, dass sie fehlt. Die Dokumentationsseite enthält das Anfrageformat und die Fehlercodes.
Drittanbieter versus offiziell: Wie du den Unterschied erkennst
Die Verwechslung ist auf dem gesamten Markt üblich, daher hilft eine kurze Checkliste, wenn du auf eine API triffst, deren Name wie der eines großen Anbieters klingt.
- Schau dir die Domain und die Nutzungsbedingungen an. Eine offizielle API lebt unter der eigenen Domain und den eigenen Bedingungen des Anbieters. Ein Drittanbieterdienst gibt dies an oder nennt wenigstens seinen eigenen Betreiber.
- Prüfe die Modellliste. Hier gibt
GET /v1/modelsdas eine Modell zurück,uncensored. Ein Router würde viele Modellnamen verschiedener Anbieter auflisten. - Lies, was versprochen wird. Behauptungen wie „das Original, aber günstiger“ sind verdächtig. Ein vertrauenswürdiger Dienst sagt dir, welche Funktionen fehlen.
- Teste es. Sende einige Anfragen mit dem kostenlosen Testguthaben, bevor du eine Arbeitslast verschiebst.
Auf dieser Seite sind die Antworten klar: unabhängiger Anbieter, ein Open-Weight-Modell, nur Text. Betrachte jede andere Lesart als Fehler. Du kannst die Identität des Modells durch Verhalten überprüfen, aber erwarte nicht, dass es behauptet, das Produkt eines bestimmten Anbieters zu sein.
Eine sinnvolle Kombination aus Text- und Bildwerkzeugen
Bildmodelle werden von Prompts gesteuert, und das Schreiben guter Prompts ist hauptsächlich eine Textaufgabe. Ein üblicher Workflow besteht daher aus zwei Schritten: Ein Sprachmodell bitten, einen detaillierten Prompt zu erzeugen, und diesen Prompt dann in den Bilddienst deiner Wahl kopieren oder leiten, egal ob von Google oder einem anderen Anbieter. Das Textmodell hier übernimmt Schritt eins.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
temperature=0.7,
messages=[
{"role": "system", "content": "Turn a short idea into a detailed prompt for a text-to-image model. Include subject, setting, lighting, color palette and mood. One paragraph."},
{"role": "user", "content": "A smuggler's market inside a hollowed-out whale skeleton, neon lanterns."},
],
)
print(resp.choices[0].message.content)
Für eine Pipeline frage nach JSON, damit die nächste Stufe Felder lesen kann. Hier ist es in Node mit dem offiziellen openai-Paket:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.imagegenapi.com/v1",
apiKey: process.env.API_KEY,
});
const res = await client.chat.completions.create({
model: "uncensored",
response_format: { type: "json_object" },
messages: [
{ role: "user", content: "Return JSON with keys prompt and style for: a whale-skeleton night market." },
],
});
const out = JSON.parse(res.choices[0].message.content);
console.log(out.prompt);
Ein paar Hinweise zu diesen Snippets. Die Systemnachricht übernimmt die Hauptarbeit, also konzentriere deine Zeit darauf. Der API-Schlüssel gehört in eine Umgebungsvariable, niemals in die Versionskontrolle. Und wenn die Anfrage mit einem 429 fehlschlägt, warte und wiederhole sie, anstatt in einer Schleife mit voller Geschwindigkeit zu wiederholen, da eine enge Schleife dein pro Minute verfügbares Kontingent schneller aufbraucht. Derselbe Code läuft unverändert bei anderen OpenAI-kompatiblen Hosts, was den Zweck des gemeinsamen Protokolls ausmacht: Du kannst den Anbieter wechseln, indem du die Basis-URL und den Modellnamen änderst.
Denke daran, dass sich die Ausrichtung auf die legale Nutzung durch Erwachsene auf den angeforderten Inhalt bezieht. Fiktion, Rollenspiele und Companion-Apps sind die typische Nutzung, und sexuelle Inhalte mit Minderjährigen werden ohne Ausnahme blockiert.
Prompts schreiben, die zu einem Bildmodell passen
Der größte Wert im Textschritt kommt von den Anweisungen, die du gibst, nicht vom Modell allein. Einige Gewohnheiten machen die Ausgabe deutlich nutzbarer.
Gib dem Modell ein festes Rezept
Sage ihm die Reihenfolge der gewünschten Teile: zuerst das Subjekt, dann die Umgebung, dann das Licht, dann die Palette, dann der Stil. Bildmodelle gewichten frühe Wörter stärker, daher sorgt eine stabile Reihenfolge für vergleichbare Ergebnisse zwischen den Läufen. Füge eine Wortgrenze hinzu, da sehr lange Prompts das Hauptsubjekt oft verwässern, anstatt es zu verbessern.
Sage, was ausgeschlossen werden soll
Einige Bildwerkzeuge verwenden einen separaten Negativ-Prompt, andere ignorieren ihn. Bitte das Textmodell, die beiden Teile als separate JSON-Felder zurückzugeben, und entferne den zweiten, wenn dein Werkzeug ihn nicht benötigt. Das ist einfacher, als einen langen Absatz manuell zu bearbeiten.
Iteriere in derselben Konversation
Behalte frühere Nachrichten in der messages-Liste und fordere Änderungen an: wärmeres Licht, weitere Einstellung, weniger Figuren. Das Kontextfenster hat 100.000 Token, selbst lange Sessions passen. Senke temperature für kleine Änderungen, erhöhe ihn für neue Ideen.
Teste einige Seeds
Wenn du denselben seed mit denselben Nachrichten und Einstellungen übergibst, bleibt die Ausgabe von Lauf zu Lauf ähnlich. Ändere nur eine Sache auf einmal, wie die Systemnachricht, und du kannst erkennen, welche Änderung das Ergebnis verbessert hat. Diese Disziplin spart mehr Geld als jede Preisklasse, da weniger verschwendete Bildgenerierungen die eigentliche Kostenersparnis darstellen.
Kosten des Textschritts
Der Preis beträgt $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token, vom Prepaid-Guthaben, ohne Abonnement. Abgelehnte oder fehlgeschlagene Anfragen werden nicht berechnet. Nimm einen Batch von 1.000 Prompt-Schreib-Aufrufen, jeder mit 400 Input-Token und 250 Output-Token.
- Input pro Aufruf: 400 / 1.000.000 x $0,15 = $0,00006.
- Output pro Aufruf: 250 / 1.000.000 x $0,50 = $0,000125.
- Pro Aufruf: $0,000185.
- Pro 1.000 Aufrufe: $0,185.
Das sind 18,5 Cent für den Batch. Vergleiche dies mit dem Preis deines Bildanbieters pro Bild, den du auf deren Preisliste nachschauen solltest, und du wirst normalerweise sehen, dass der Prompt-Schreib-Schritt der günstigere ist.
Erste Schritte mit Guthaben
Neue Nutzer können $0,50 Testguthaben mit einem Klick auf der API-Schlüssel-Seite nach der Anmeldung mit Google oder mit E-Mail und Passwort beanspruchen. Es erfordert keine Zahlung und dauert 7 Tage. Danach kannst du mit einem beliebigen ganzen Betrag von $20 bis $500 in Krypto (USDT auf TRC20 oder USDC auf Base) aufladen. Boni sind +5% ab $50, +10% ab $100 und +15% ab $200, und Guthaben verfällt nie. Siehe Preise für das vollständige Bild.
Grenzen zur Planung
Ein voller Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Test-Schlüssel erlaubt 2 parallele und 60 pro Minute. Das Überschreiten des ersten gibt HTTP 429 mit Code rate_limited, das Überschreiten des zweiten gibt 429 mit Code concurrency, und eine temporäre Überlastung gibt 429 mit einem Retry-After: 5-Header. Eine gestreamte Anfrage belegt ihren Slot, bis das Streaming endet, also schließe Streams, die du nicht mehr benötigst.
Antwort-Header umfassen X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency. Logge die Request-ID bei jedem Fehler, da dies der schnellste Weg ist, Hilfe vom Support zu erhalten. Die maximale Body-Größe beträgt 8 MB.
Wenn du eine native Gemini-Bildanfrage benötigst, gehe zu Google und lies deren aktuelle Dokumentation. Wenn du ein unzensiertes Textmodell benötigst, das das OpenAI-Protokoll spricht, um Prompts, Geschichten oder Charakterdialoge für die legale Nutzung durch Erwachsene zu schreiben, ist dies dafür gebaut.
