Proporcje obrazu, rozdzielczości i formaty wyjściowe
Na tej stronie
Zaktualizowano 2 listopada 2026 r. — Imagine. Model
grok-imagine-image-qualityzostał wycofany z dniem 2 listopada 2026 r. (jego żądania są teraz obsługiwane przez Imagine 2.0 w jakościlow): przykłady wykorzystują obecniegrok-imagine-image(Imagine 1.0) orazgrok-imagine-image-2.0(Imagine 2.0, jakośćlow,mediumlubauto). Korzystając z OpenAI SDK, parametryaspect_ratio,resolutioniqualityprzesyłasz przezextra_body, a edycja odbywa się za pośrednictwem xAI SDK lub żądania HTTP.
Opanuj wymiary swoich obrazów
Wybrane przez Ciebie proporcje i rozdzielczość bezpośrednio wpływają na wygląd i przydatność wygenerowanych obrazów. API Grok Imagine oferuje znaczną elastyczność dzięki licznych zdefiniowanym proporcjom oraz dwóm poziomom rozdzielczości.
Dostępne proporcje obrazu
Wybierz proporcje w zależności od miejsca docelowego publikacji i zrób to przed generowaniem. Przycięcie kwadratowego obrazu do panoramicznego banera po fakcie niszczy kompozycję zbudowaną przez model dla formatu kwadratowego: obiekt główny ląduje poza środkiem, marginesy znikają. Generowanie od razu w odpowiednim formacie kosztuje tyle samo, a daje obraz zaprojektowany idealnie pod jego proporcje.
| Proporcje | Orientacja | Typowe zastosowanie |
|---|---|---|
| 1:1 | Kwadrat | Zdjęcia profilowe, ikony, Instagram |
| 16:9 | Szeroki pejzaż | Prezentacje, banery, wideo |
| 9:16 | Pionowy portret | Relacje (Stories), Reels, TikTok |
| 4:3 | Klasyczny pejzaż | Tradycyjne zdjęcia, dokumenty |
| 3:4 | Portret | Plakaty, okładki książek |
| 3:2 / 2:3 | Standardowe zdjęcie | Wydruki fotograficzne, pocztówki |
| 2:1 / 1:2 | Ultra szeroki / ultra pionowy | Banery internetowe, panoramy |
| auto | Automatycznie | Model wybiera optymalne proporcje |
Dostępne są również dodatkowe proporcje dla specyficznych przypadków, takich jak ekrany smartfonów: 9:19.5, 19.5:9, 9:20 i 20:9.
Rozdzielczości: 1k kontra 2k
Wybór między 1k a 2k nie polega na pytaniu „co jest lepsze“, lecz „gdzie ten obraz będzie wyświetlany“. Na ekranie różnica jest niewidoczna dla zdecydowanej większości zastosowań webowych, a 2k kosztuje jedynie dodatkowy czas generowania. Sytuacja zmienia się diametralnie w przypadku druku, gdzie liczba pikseli na centymetr bezpośrednio decyduje o postrzeganej ostrości.
1k: Standardowa rozdzielczość, idealna do większości zastosowań w sieci. Szybszy czas generowania.2k: Wysoka rozdzielczość, doskonała do druku lub grafik wymagających dużej ilości detali.
# Standardowa rozdzielczość do zastosowań webowych
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Ikona aplikacji mobilnej w stylu neonowym",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Wysoka rozdzielczość do druku
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Plakat koncertowy w stylu art deco z elegancką typografią",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Formaty odpowiedzi
Parametr response_format określa, w jaki sposób obraz zostanie Ci zwrócony:
Tymczasowy URL (domyślnie)
response = client.images.generate(
model="grok-imagine-image",
prompt="Kot astronauta",
response_format="url"
)
# response.data[0].url → Tymczasowy URL, pobierz go szybko
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Kot astronauta",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
Kluczowym słowem jest tutaj tymczasowy: zwracany URL wygasa. Aplikacja, która zapisze go w bazie danych i spróbuje wyświetlić几周 później, napotka problem zerwanych linków do obrazów, często długo po wdrożeniu. Masz dwa wyjścia: natychmiast pobierz obraz z URL-a lub zażądaj go bezpośrednio w formacie Base64 – w obu przypadkach obraz musi trafić na Twój własny nośnik danych.
Wybór właściwej kombinacji
Dla każdego przypadku użycia oto zalecane kombinacje:
- Post na Instagramie:
1:1, rozdzielczość1k, Imagine 1.0 - Relacja/Reels:
9:16, rozdzielczość1k, Imagine 1.0 - Baner internetowy:
16:9lub2:1, rozdzielczość1k, Imagine 1.0 - Plakat wydarzeniowy:
3:4, rozdzielczość2k, Imagine 2.0 w jakościmedium - Ilustracja do artykułu:
16:9, rozdzielczość2k, Imagine 2.0 w jakościmedium
Kluczowe wnioski
- Dostępnych ponad 10 proporcji obrazu, plus tryb
auto - Dwie rozdzielczości:
1k(szybka, do sieci) i2k(szczegółowa, do druku) - Dwa formaty odpowiedzi:
url(tymczasowy) ib64_json(trwały) - Zwracane typy MIME mogą to być PNG, JPEG lub WebP
- Dostosuj proporcje do kanału dystrybucji swojego obrazu