Generowanie obrazów GPT-Image-2

• Model: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Tryb: Asynchroniczny — zwraca task_id, następnie sprawdź wynik zadania
• Funkcje: Generowanie tekst-obraz; generowanie obraz-obraz z maksymalnie 16 obrazami referencyjnymi (mieszanka URL + base64)

Autoryzacja

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parametry ciała żądania

Pole	Typ	Wymagane	Uwagi
model	string	tak	gpt-image-2
prompt	string	tak	Opis sceny; obowiązuje moderacja treści
n	integer	nie	Tylko 1 (liczba, bez cudzysłowu)
size	string	nie	Proporcje obrazu, domyślnie 1:1
resolution	string	nie	1k / 2k / 4k, domyślnie 1k
image_urls	array	nie	Obrazy referencyjne → generowanie obraz-obraz
official_fallback	boolean	nie	Rezerwowy kanał oficjalny, domyślnie false

Wartości size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 lub ciągi pikseli, np. 3840x2160.

Rozdzielczość (przykładowe piksele)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Wszystkie 15 proporcji obsługuje 4K.

image_urls

• Maksymalnie 16 obrazów
• Publiczne URL i base64 data URI mogą być mieszane
• Pomiń size, aby dopasować rozdzielczość wejściową; ustaw size, aby wymusić proporcje wyjściowe

Przykłady

Minimalne generowanie tekst-obraz

{
  "model": "gpt-image-2",
  "prompt": "Pomarańczowy kot na parapecie o zachodzie słońca, akwarela"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "corgi astronauta na księżycu, kinowy",
    "size": "16:9",
    "resolution": "2k"
  }'

Odpowiedź po wysłaniu

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

HTTP	Znaczenie
400	Nieprawidłowe parametry
401	Nieprawidłowy klucz API
402	Niewystarczające środki
429	Przekroczono limit żądań

Sprawdź wynik zadania

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL obrazu: data.result.images[0].url[0]

status	Znaczenie
submitted	W kolejce
processing	W trakcie
completed	Gotowe
failed	Zobacz błąd

Sprawdzaj po 10–20 s, co 3–5 s. Batch: POST https://apimaster.ai/v1/tasks/batch z {"task_ids":[...]}.

Uwagi

• Tylko tryb asynchroniczny — brak synchronicznego URL obrazu w odpowiedzi tworzenia.
• Preferuj size dla proporcji; unikaj powtarzania proporcji w prompt.
• Rozliczanie według poziomu rozdzielczości; sprawdź konsolę dla swojego konta.

Porównaj z oficjalnym kanałem.