Gemini 3.1 Flash Image Preview

• Model: gemini-3.1-flash-image-preview (stały)
• Funkcje: Tekst na obraz, obraz na obraz (do 14 referencji), do 4K, ekstremalne proporcje, opcjonalne wyszukiwanie Google (grounding)

Nie wywołuj tego modelu przez /v1/chat/completions — otrzymasz 400 z podpowiedzią, aby użyć Images API.

Endpointy

Tryb	Endpoint	Kiedy używać
Synchroniczny (zalecany)	POST https://apimaster.ai/v1/images/generations	Jedna runda HTTP; platforma sonduje upstream i zwraca { "data": [{ "url" }] }
Asynchroniczny	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Długie zadania, niestandardowe kolejki

Szybki start (synchroniczny)

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
  }'

Sukces

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

Ustaw limit czasu odczytu HTTP na ≥ 180s dla 2K/4K. Pobierz lub utwórz kopię URL-i niezwłocznie — wygasają.

Przepływ asynchroniczny

Wyślij

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
  }'

Odpowiedź na wysłanie

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

Sondowanie

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

Po sukcesie odczytaj data.result.images[0].url. Typowe statusy sondowania: in_progress → succeeded / completed.

Poczekaj 10–20s przed pierwszym sondowaniem, potem co 3–5s.

Autoryzacja

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parametry ciała żądania

Pole	Typ	Wymagane	Uwagi
model	string	tak	gemini-3.1-flash-image-preview
prompt	string	tak	Opis sceny
size	string	nie	Proporcje; patrz poniżej
resolution	string	nie	0.5K / 1K / 2K / 4K, domyślnie 1K; niewrażliwe na wielkość liter
n	integer	nie	Tylko 1 obsługiwane (numeryczne, nie string)
image_urls	array	nie	Obrazy referencyjne (URL lub data URI)
google_search	boolean	nie	Ugruntowanie wyszukiwaniem Google
google_image_search	boolean	nie	Wymaga google_search: true

Rozdzielczość i poziomy rozliczeń

Wartość	~piksele	Cena vs 1K podstawa
0.5K	~512	taka sama jak 1K
1K	~1024	podstawa
2K	~2048	× 4/3
4K	~4096	× 2

Rzeczywista opłata = cena kanału × mnożnik rozdzielczości × współczynnik grupy. Zobacz marketplace lub logi konsoli.

Błędy

HTTP	Znaczenie
400	Złe parametry lub zły endpoint (chat)
401	Nieprawidłowy klucz API
402	Niewystarczające saldo
408	Przekroczono limit czasu sondowania synchronicznego — spróbuj asynchronicznie lub zmniejsz rozdzielczość
500 / 502	Błąd upstream lub platformy

Nieprawidłowe proporcje mogą objawiać się jako 500, gdy skonfigurowany jest tylko jeden kanał.

Uwagi

• Logi użycia zawierają result_url do podglądu obrazu oraz request_data.effective_resolution.
• Ceny różnią się w zależności od kanału i rozdzielczości — zobacz marketplace.