Parametry GPT Image 2 API: rozmiar, rozdzielczość, proporcje i jakość
Parametry GPT Image 2 API, które kształtują obraz: nazwa modelu, rozmiar i rozdzielczość, proporcje, limity 4K, jakość, formaty i zwracane przez nie błędy.
Czytaj jako MarkdownGPT Image 2 API przyjmuje nazwę modelu w model, wymiary wyjścia w size jako piksele w formacie WIDTHxHEIGHT oraz jakość w quality (low, medium, high lub auto). Nie ma pola resolution ani aspect_ratio. Aby dostać obraz 16:9 w 4K, wysyłasz "size": "3840x2160". Rozmiary muszą być wielokrotnościami 16, obie krawędzie nie mogą przekraczać 3840 pikseli, proporcje muszą mieścić się między 1:3 a 3:1, a łączna liczba pikseli między 655 360 a 8 294 400.
Ten przewodnik omawia każdy parametr, który zmienia obraz, z dokładną wartością do wysłania i błędem, jaki zwraca zła wartość. Każdy błąd poniżej został sprawdzony na działającym API.
Jaka jest nazwa modelu GPT Image 2 w API?
Użyj gpt-image-2 lub gpt-image-2-official. To ten sam model z tymi samymi polami; gpt-image-2 nalicza jedną stałą cenę za każdy dostarczony obraz, a gpt-image-2-official rozlicza tokeny raportowane przez każdy render.
Nazwy z nagłówków nie działają jako ID modelu. gpt-image-2.0, GPT Image 2 czy chatgpt-images-2 zwracają HTTP 400 z kodem błędu 20002.
Jak ustawić rozdzielczość i proporcje obrazu?
Przez size, w pikselach. Wybierz proporcje i budżet pikseli, jakiego chcesz, a potem wyślij wynikową szerokość i wysokość:
| Proporcje | Około 1K | Około 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1456x624 | 3024x1296 | 3808x1632 |
| 3:1 | 1728x576 | 3504x1168 | 3840x1280 |
To te same przeliczenia, których używa Playground, gdy wybierasz proporcje i ustawienie 1K, 2K lub 4K. Kwadratowy obraz 4K kończy się na 2880x2880, bo kwadrat o boku 3840 pikseli przekroczyłby limit łącznej liczby pikseli.
size: "auto" pozostawia wymiary modelowi. To wartość domyślna i jest wygodna, ale ustaw rozmiar wprost, gdy wyniki muszą pasować do układu albo do siebie nawzajem.
OpenAI opisuje wyjście powyżej 2560×1440 jako eksperymentalne. W podanych tu limitach jest akceptowane, ale większe płótno nie gwarantuje większej liczby szczegółów.
Które wartości size są odrzucane?
| Wysłana wartość | Dlaczego nie działa | Odpowiedź |
|---|---|---|
"size": "16:9" | Proporcje to nie rozmiar | 400 20001, komunikat wskazuje size |
"size": "4096x2304" | Krawędź powyżej 3840 | 400 20001, komunikat wskazuje size |
"size": "1000x1000" | Nie jest wielokrotnością 16 | 400 20001, komunikat wskazuje size |
"size": "3840x1024" | Szerszy niż 3:1 | 400 20001, komunikat wskazuje size |
"resolution": "4k" | Nieznane pole | 400 20001, bez nazwy pola |
"aspect_ratio": "16:9" | Nieznane pole | 400 20001, bez nazwy pola |
Zwróć uwagę na dwa ostatnie wiersze. Nieznane pole jest odrzucane, ale błąd go nie nazywa. Jeśli dostajesz 20001 z ogólnym komunikatem „Check the parameters against the API documentation”, szukaj pola, którego API nie przyjmuje, np. resolution, aspect_ratio albo response_format.
Jaką jakość wybrać?
quality przyjmuje low, medium, high i auto. Wyższe poziomy trwają dłużej i oddają drobniejsze szczegóły. xhigh i max należą wyłącznie do GPT Image 2.5; wysłanie ich do GPT Image 2 zwraca 20001 z komunikatem wskazującym quality.
Praktyczny schemat: szkicuj w low, dopóki kompozycja się zmienia, sprawdzaj fakturę i drobny tekst w medium, a wersje finalne generuj w high. W gpt-image-2 cena jest taka sama na każdym poziomie. W gpt-image-2-official wyższe poziomy raportują więcej tokenów wyjściowych, więc kosztują więcej. Liczby pokazuje przewodnik po cenach.
auto pozwala modelowi wybrać poziom. Ustaw wartość wprost, gdy porównujesz uruchomienia, bo inaczej dwa „identyczne” żądania mogą wyrenderować się na różnych poziomach.
Co steruje formatem i tłem?
output_format:png(domyślnie) lubjpeg. Wyjście WebP nie jest dostępne;webpzwraca20001z komunikatem wskazującymoutput_format.output_compression: od 0 do 100, tylko zjpeg.background:auto,opaquelubtransparent. Przezroczystość wymagapng;transparentzjpegzwraca20001z komunikatem wskazującymbackground.n: od 1 do 10 obrazów na żądanie. Płacisz za dostarczone obrazy.moderation:autolublow.
Jak przekazać obrazy referencyjne i maski?
Jako adresy URL, nigdy jako pliki ani base64. images przyjmuje od 1 do 16 obiektów w kształcie {"image_url": "https://..."}, a jego wysłanie zamienia żądanie w edycję. mask przyjmuje jeden obiekt o tym samym kształcie: plik PNG o rozmiarze pierwszego obrazu referencyjnego, w którym przezroczysty obszar oznacza, co zmienić. Limity plików wymienia dokumentacja.
Najczęstsze pytania
Czy GPT Image 2 obsługuje 4K?
Tak, w opisanych wyżej limitach. 3840x2160 dla 16:9 i 2160x3840 dla 9:16 to największe kadry, a 2880x2880 to największy kwadrat.
Czy mogę wysłać proporcje zamiast pikseli?
Nie do API. Najpierw przelicz proporcje na rozmiar WIDTHxHEIGHT, korzystając z tabeli powyżej albo z Playgroundu, który pokazuje dokładny rozmiar przed wysłaniem.
Jaki jest domyślny rozmiar i jakość?
Oba mają domyślnie auto, co pozostawia wybór modelowi. Wysyłaj jawne wartości, gdy potrzebujesz przewidywalnego wyniku.
Wysyłaj piksele, ustaw jakość, czytaj komunikat błędu
Niemal każdy problem z parametrami to jedna z trzech rzeczy: proporcje wysłane jako rozmiar, pole, którego API nie przyjmuje, albo wartość poza limitami. W pierwszym i trzecim przypadku komunikat błędu wskazuje pole; ogólny komunikat bez nazwy pola wskazuje drugi. Podczas integracji trzymaj tę stronę obok dokumentacji GPT Image 2 API.
