Képarányok, felbontások és kimeneti formátumok
Ezen az oldalon
Frissítve: 2026. november 2. — Imagine. A
grok-imagine-image-qualitymodell 2026. november 2-tól megszűnt (a kéréseit az Imagine 2.0 szolgálja kilowminőségben): a példák most agrok-imagine-image(Imagine 1.0) és agrok-imagine-image-2.0(Imagine 2.0,low,mediumvagyautominőség) modelleket használják. Az OpenAI SDK-val azaspect_ratio,resolutionésqualityparamétereket azextra_bodyobjektumon keresztül adod át, míg a szerkesztés az xAI SDK-n vagy egy HTTP-kérésen keresztül történik.
A képméretek elsajátítása
A választott képarány és felbontás közvetlenül meghatározza a generált képek megjelenését és felhasználhatóságát. A Grok Imagine API jelentős rugalmasságot biztosít számos előre definiált aránnyal és két felbontási szinttel.
Elérhető képarányok
Az arányt a célplatform alapján válaszd ki, mégpedig a generálás előtt. Ha utólag vágsz le egy négyzet alakú képet panoráma banner méretre, az beleavatkozik a modell által négyzetre tervezett kompozícióba: a téma félre kerül, a margók eltűnnek. Ha közvetlenül a megfelelő formátumban generálsz, az ugyanannyiba kerül, és az arányokhoz igazodó képet kapsz eredményül.
| Arány | Tájolás | Tipikus felhasználás |
|---|---|---|
| 1:1 | Négyzet | Profilképek, ikonok, Instagram |
| 16:9 | Széles fekvő | Prezentációk, bannerek, videók |
| 9:16 | Függőleges álló | Stories, Reels, TikTok |
| 4:3 | Klasszikus fekvő | Hagyományos fotók, dokumentumok |
| 3:4 | Álló | Poszterek, könyvborítók |
| 3:2 / 2:3 | Szabványos fotó | Fotónyomtatás, képeslapok |
| 2:1 / 1:2 | Ultra széles / ultra álló | Webes bannerek, panorámák |
| auto | Automatikus | A modell választja ki az optimális arányt |
További arányok is elérhetők specifikus esetekhez, például okostelefon-képernyőkhöz: 9:19.5, 19.5:9, 9:20 és 20:9.
Felbontások: 1k vs 2k
Az 1k és 2k közötti választásnál nem az a kérdés, hogy „melyik a legjobb“, hanem hogy „hol fogják megtekinteni a képet“. Képernyőn a különbség a webes felhasználások túlnyomó többségében láthatatlan, a 2k pedig csak plusz generálási időt igényel. Nyomtatás esetén azonban kritikussá válik, ahol a centiméterenkénti képpontszám közvetlenül meghatározza az észlelt élességet.
1k: Szabványos felbontás, a legtöbb webes felhasználáshoz ideális. Gyorsabb generálási idő.2k: Nagy felbontás, nyomtatáshoz vagy nagy részletigényt igénylő vizuálokhoz tökéletes.
# Szabványos felbontás webhez
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon stílusú mobilalkalmazás-ikon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Nagy felbontás nyomtatáshoz
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco koncertposzter elegáns tipográfiával",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Válaszformátumok
A response_format paraméter határozza meg, hogyan kapod vissza a képet:
Ideiglenes URL (alapértelmezett)
response = client.images.generate(
model="grok-imagine-image",
prompt="Űrhajós macska",
response_format="url"
)
# response.data[0].url → Ideiglenes URL, töltsd le gyorsan
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Űrhajós macska",
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)
A kulcsszó az ideiglenes: a visszaadott URL lejár. Ha egy alkalmazás elmenti ezt az adatbázisba, és hetekkel később jeleníti meg, a képek törött linkként fognak megjelenni, gyakran jóval a telepítés után. Két megoldás létezik: azonnal töltsd le a képet az URL-ről, vagy kérj közvetlenül Base64 formátumot – mindkét esetben a képet a saját tárhelyeden kell elhelyezned.
A megfelelő kombináció kiválasztása
Minden felhasználási esethez itt vannak az ajánlott kombinációk:
- Instagram-bejegyzés:
1:1,1kfelbontás, Imagine 1.0 - Story/Reel:
9:16,1kfelbontás, Imagine 1.0 - Webes banner:
16:9vagy2:1,1kfelbontás, Imagine 1.0 - Rendezvényposzter:
3:4,2kfelbontás, Imagine 2.0mediumminőségben - Cikkillusztráció:
16:9,2kfelbontás, Imagine 2.0mediumminőségben
Főbb megállapítások
- Több mint 10 képarány elérhető, plusz
automód - Két felbontás:
1k(gyors, web) és2k(részletes, nyomtatás) - Két válaszformátum:
url(ideiglenes) ésb64_json(tartós) - A visszaadott MIME-típusok lehetnek PNG, JPEG vagy WebP
- Igazítsd az arányt a képed terjesztési csatornájához