Gemini 3.1 Flash Image Preview

• Modell: gemini-3.1-flash-image-preview (festgelegt)
• Funktionen: Text-zu-Bild, Bild-zu-Bild (bis zu 14 Referenzen), bis zu 4K, extreme Seitenverhältnisse, optionale Google-Suche Grounding

Rufen Sie dieses Modell nicht über /v1/chat/completions auf — Sie erhalten 400 mit einem Hinweis, die Images API zu verwenden.

Endpunkte

Modus	Endpunkt	Wann verwenden
Synchron (empfohlen)	POST https://apimaster.ai/v1/images/generations	Ein HTTP-Roundtrip; Plattform pollt upstream und gibt { "data": [{ "url" }] } zurück
Asynchron	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Lange Aufträge, benutzerdefinierte Warteschlangen

Schnellstart (synchron)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk city at night, neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Erfolg

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Setzen Sie das HTTP-Lese-Timeout auf ≥ 180s für 2K/4K. Laden Sie URLs umgehend herunter oder spiegeln Sie sie — sie laufen ab.

Asynchroner Ablauf

Einreichen

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "a corgi astronaut on the moon",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Antwort auf Einreichung

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Abrufen

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

Bei Erfolg lesen Sie data.result.images[0].url. Typische Poll-Status: in_progress → succeeded / completed.

Warten Sie 10–20s vor dem ersten Poll, dann alle 3–5s.

Authentifizierung

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Körperparameter

Feld	Typ	Erforderlich	Anmerkungen
model	string	ja	gemini-3.1-flash-image-preview
prompt	string	ja	Szenenbeschreibung
size	string	nein	Seitenverhältnis; siehe unten
resolution	string	nein	0.5K / 1K / 2K / 4K, Standard 1K; Groß-/Kleinschreibung nicht beachtet
n	integer	nein	Nur 1 unterstützt (numerisch, nicht String)
image_urls	array	nein	Referenzbilder (URL oder data URI)
google_search	boolean	nein	Google-Textsuche Grounding
google_image_search	boolean	nein	Erfordert google_search: true

Auflösung & Abrechnungsstufen

Wert	~Pixel	Preis im Vergleich zu 1K-Basis
0.5K	~512	gleich wie 1K
1K	~1024	Basis
2K	~2048	× 4/3
4K	~4096	× 2

Tatsächliche Gebühr = Kanalpreis × Auflösungsmultiplikator × Gruppenverhältnis. Siehe Marktplatz oder Konsolenprotokolle.

Fehler

HTTP	Bedeutung
400	Falsche Parameter oder falscher Endpunkt (Chat)
401	Ungültiger API-Schlüssel
402	Unzureichendes Guthaben
408	Synchroner Poll-Timeout — asynchron wiederholen oder Auflösung verringern
500 / 502	Upstream- oder Plattformfehler

Ungültige Seitenverhältnisse können als 500 auftreten, wenn nur ein Kanal konfiguriert ist.

Hinweise

• Nutzungsprotokolle enthalten result_url für die Bildvorschau und request_data.effective_resolution.
• Die Preisgestaltung variiert je nach Kanal und Auflösung — siehe Marktplatz.