Poměr stran, rozlišení a výstupní formáty
Na této stránce
Aktualizováno 2. listopadu 2026 — Imagine. Model
grok-imagine-image-qualitybyl k 2. listopadu 2026 odstraněn (jeho požadavky nyní obsluhuje Imagine 2.0 v kvalitělow): příklady nyní využívajígrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumneboauto). Při použití OpenAI SDK předáváš parametryaspect_ratio,resolutionaqualityprostřednictvímextra_body, zatímco úpravy probíhají přes xAI SDK nebo HTTP požadavek.
Ovládni rozměry svých obrázků
Poměr stran a rozlišení, které zvolíš, přímo určují vzhled a využití tvých generovaných obrázků. API Grok Imagine nabízí značnou flexibilitu s mnoha předdefinovanými poměry a dvěma úrovněmi rozlišení.
Dostupné poměry stran
Poměr vybírej podle cílového místa použití a udělej to před samotným generováním. Pokud následně ořízneš čtvercový obrázek na panoramatický banner, narušíš kompozici, kterou model pro čtverec vytvořil: subjekt skončí mimo střed a zmizí okraje. Generování přímo ve správném formátu stojí stejně a poskytne ti obrázek navržený pro dané proporce.
| Poměr | Orientace | Typické použití |
|---|---|---|
| 1:1 | Čtverec | Profily, ikony, Instagram |
| 16:9 | Široký formát na šířku | Prezentace, bannery, video |
| 9:16 | Svislý portrét | Stories, Reels, TikTok |
| 4:3 | Klasický formát na šířku | Tradiční fotografie, dokumenty |
| 3:4 | Portrét | Plakáty, obálky knih |
| 3:2 / 2:3 | Standardní fotografie | Fototisk, pohlednice |
| 2:1 / 1:2 | Ultra široký / ultra svislý | Webové bannery, panoramata |
| auto | Automaticky | Model zvolí optimální poměr |
Pro specifické případy, jako jsou obrazovky chytrých telefonů, jsou k dispozici další poměry: 9:19.5, 19.5:9, 9:20 a 20:9.
Rozlišení: 1k vs. 2k
Mezi 1k a 2k není otázkou „co je lepší“, ale „kde bude tento obrázek zobrazen“. Na obrazovce je rozdíl pro drtivou většinu webových použití neviditelný a 2k pouze prodlužuje dobu generování. Kritickým se to stává až u tisku, kde počet pixelů na centimetr přímo určuje vnímanou ostrost.
1k: Standardní rozlišení, vhodné pro většinu webových použití. Rychlejší doba generování.2k: Vysoké rozlišení, ideální pro tisk nebo vizuály vyžadující mnoho detailů.
# Standardní rozlišení pro web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon-style mobile app icon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Vysoké rozlišení pro tisk
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco concert poster with elegant typography",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Formáty odpovědi
Parametr response_format určuje, jakým způsobem ti bude obrázek vrácen:
Dočasná URL (výchozí)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="url"
)
# response.data[0].url → Dočasná URL, stáhni rychle
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
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)
Klíčovým slovem je dočasná: vrácená URL vyprší. Aplikace, která ji uloží do databáze a zobrazí až po týdnech, narazí na nefunkční obrázky, často dlouho po nasazení. Fungují dvě možnosti: buď obrázek z URL okamžitě stáhneš, nebo si rovnou vyžádáš Base64 – v obou případech musí obrázek skončit na tvém vlastním úložišti.
Výběr správné kombinace
Pro jednotlivé případy použití zde jsou doporučené kombinace:
- Příspěvek na Instagram:
1:1, rozlišení1k, Imagine 1.0 - Story/Reel:
9:16, rozlišení1k, Imagine 1.0 - Webový banner:
16:9nebo2:1, rozlišení1k, Imagine 1.0 - Plakát na akci:
3:4, rozlišení2k, Imagine 2.0 v kvalitěmedium - Ilustrace článku:
16:9, rozlišení2k, Imagine 2.0 v kvalitěmedium
Klíčové poznatky
- K dispozici je více než 10 poměrů stran plus režim
auto - Dvě rozlišení:
1k(rychlé, web) a2k(detailní, tisk) - Dva formáty odpovědi:
url(dočasné) ab64_json(trvalé) - Vrácené typy MIME mohou být PNG, JPEG nebo WebP
- Přizpůsob poměr kanálu, kde budeš obrázek šířit