Pomery strán, rozlíšenia a výstupné formáty
Na tejto strane
Aktualizované 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualitybol k 2. novembru 2026 odstránený (jeho požiadavky teraz vybavuje Imagine 2.0 v kvalitelow): príklady teraz využívajúgrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumaleboauto). Pri používaní OpenAI SDK sa parametreaspect_ratio,resolutionaqualityodovzdávajú cezextra_body, zatiaľ čo úpravy prebiehajú prostredníctvom xAI SDK alebo HTTP požiadavky.
Ovládnite rozmery svojich obrázkov
Pomer strán a rozlíšenie, ktoré si vyberieš, priamo určujú vzhľad a využiteľnosť tvojich generovaných obrázkov. API Grok Imagine ponúka značnú flexibilitu s množstvom preddefinovaných pomerov a dvoma úrovňami rozlíšenia.
Dostupné pomery strán
Pomer vyberaj podľa cieľovej platformy a urob tak pred samotným generovaním. Ak následne orežeš štvorcový obrázok na panoramatický banner, narušíš kompozíciu, ktorú model vytvoril pre štvorec: subjekt skončí mimo stred, okraje zmiznú. Generovanie priamo v správnom formáte stojí rovnako a poskytne ti obrázok navrhnutý presne pre tieto proporcie.
| Pomer | Orientácia | Typické použitie |
|---|---|---|
| 1:1 | Štvorec | Profily, ikony, Instagram |
| 16:9 | Široký formát na šírku | Prezentácie, bannery, video |
| 9:16 | Zvislý portrét | Stories, Reels, TikTok |
| 4:3 | Klasický formát na šírku | Tradičné fotky, dokumenty |
| 3:4 | Portrét | Plagáty, obálky kníh |
| 3:2 / 2:3 | Štandardná fotografia | Fototlače, pohľadnice |
| 2:1 / 1:2 | Ultra široký / ultra zvislý | Webové bannery, panorámy |
| auto | Automaticky | Model vyberie optimálny pomer |
K dispozícii sú aj ďalšie pomery pre špecifické prípady, ako sú obrazovky smartfónov: 9:19.5, 19.5:9, 9:20 a 20:9.
Rozlíšenia: 1k vs 2k
Pri výbere medzi 1k a 2k nie je otázkou „čo je lepšie“, ale „kde bude tento obrázok zobrazený“. Na obrazovke je rozdiel pre väčšinu webových použití neviditeľný a 2k stojí len extra čas generovania. Kritickým sa to stáva pri tlači, kde počet pixelov na centimeter priamo určuje vnímanú ostrosť.
1k: Štandardné rozlíšenie, vhodné pre väčšinu webových použití. Rýchlejší čas generovania.2k: Vysoké rozlíšenie, ideálne pre tlač alebo vizuály vyžadujúce veľa detailov.
# Štandardné rozlíšenie pre 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é rozlíšenie pre tlač
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 odpovede
Parameter response_format určuje, ako ti bude obrázok vrátený:
Dočasná URL (Predvolené)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="url"
)
# response.data[0].url → Dočasná URL, rýchlo stiahnuť
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)
Kľúčovým slovom je dočasná: vrátená URL vyprší. Aplikácia, ktorá ju uloží do databázy a zobrazí o niekoľko týždňov, narazí na nefunkčné obrázky, často až dlho po nasadení. Fungujú dve možnosti: okamžite stiahnuť obrázok z URL, alebo si vyžiadať priamo Base64 – v oboch prípadoch musí obrázok skončiť na tvojom vlastnom úložisku.
Výber správnej kombinácie
Pre každý prípad použitia sú tu odporúčané kombinácie:
- Príspevok na Instagram:
1:1, rozlíšenie1k, Imagine 1.0 - Story/Reel:
9:16, rozlíšenie1k, Imagine 1.0 - Webový banner:
16:9alebo2:1, rozlíšenie1k, Imagine 1.0 - Plagát na podujatie:
3:4, rozlíšenie2k, Imagine 2.0 v kvalitemedium - Ilustrácia článku:
16:9, rozlíšenie2k, Imagine 2.0 v kvalitemedium
Kľúčové poznatky
- K dispozícii je viac ako 10 pomerov strán plus režim
auto - Dve rozlíšenia:
1k(rýchle, web) a2k(detailné, tlač) - Dva formáty odpovede:
url(dočasné) ab64_json(trvalé) - Vrátene MIME typy môžu byť PNG, JPEG alebo WebP
- Prispôsob pomer kanálu distribúcie tvojho obrázka