Proporcijas, izšķirtspējas un izvades formāti
Šajā lapā
Atjaunināts 2026. gada 2. novembrī — Imagine.
grok-imagine-image-qualityir izņemts no aprites kopš 2026. gada 2. novembra (tā pieprasījumus apstrādā Imagine 2.0 arlowkvalitāti): piemēros tagad tiek izmantotigrok-imagine-image(Imagine 1.0) ungrok-imagine-image-2.0(Imagine 2.0 arlow,mediumvaiautokvalitāti). Izmantojot OpenAI SDK, parametriaspect_ratio,resolutionunqualitytiek nodoti caurextra_body, bet rediģēšana notiek, izmantojot xAI SDK vai HTTP pieprasījumu.
Attēla izmēru apgūšana
Izvēlētā proporcija un izšķirtspēja tieši nosaka ģenerēto attēlu izskatu un pielietojumu. Grok Imagine API piedāvā ievērojamu elastību ar daudziem iepriekš definētiem malu attiecībām un diviem izšķirtspējas līmeņiem.
Pieejamās malu attiecības
Izvēlies attiecību atbilstoši galamērķim un izdari to pirms ģenerēšanas. Kvadrātveida attēla apgriešana panorāmas banerī pēc fakta bojā kompozīciju, ko modelis veidoja kvadrātam: subjekts nonāk ārpus centra, pazūd malas. Ģenerēšana tieši pareizajā formātā maksā tikpat, bet dod attēlu, kas projektēts tā proporcijām.
| Attiecība | Orientācija | Tipisks pielietojums |
|---|---|---|
| 1:1 | Kvadrāts | Profili, ikonas, Instagram |
| 16:9 | Plats ainavas formāts | Prezentācijas, baneri, video |
| 9:16 | Vertikāls portrets | Stāsti, Reels, TikTok |
| 4:3 | Klasisks ainavas formāts | Tradicionālas fotogrāfijas, dokumenti |
| 3:4 | Portrets | Plakāti, grāmatu vāki |
| 3:2 / 2:3 | Standarta foto | Foto drukas, pastkartes |
| 2:1 / 1:2 | Īpaši plats / īpaši vertikāls | Tīmekļa baneri, panorāmas |
| auto | Automātiski | Modelis izvēlas optimālo attiecību |
Ir pieejamas arī papildu attiecības specifiskiem gadījumiem, piemēram, viedtālruņu ekrāniem: 9:19.5, 19.5:9, 9:20 un 20:9.
Izšķirtspējas: 1k pret 2k
Starp 1k un 2k jautājums nav „kura ir labāka”, bet gan „kur šis attēls tiks skatīts”. Ekrānā atšķirība lielākajai daļai tīmekļa lietojumu ir nemanāma, un 2k tikai palielina ģenerēšanas laiku. Tomēr tas kļūst kritiski svarīgi drukāšanai, kur pikseļu skaits uz centimetru tieši nosaka uztveramo asumu.
1k: Standarta izšķirtspēja, piemērota lielākajai daļai tīmekļa lietojumu. Ātrāks ģenerēšanas laiks.2k: Augsta izšķirtspēja, ideāli piemērota drukai vai vizuāliem materiāliem, kuriem nepieciešams daudz detaļu.
# Standarta izšķirtspēja tīmeklim
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neona stila mobilās lietotnes ikona",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Augsta izšķirtspēja drukai
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco koncerta plakāts ar elegantu tipogrāfiju",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Atbildes formāti
Parametrs response_format nosaka, kā attēls tiek atgriezts tev:
Pagaidu URL (noklusējums)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronautu kaķis",
response_format="url"
)
# response.data[0].url → Pagaidu URL, lejupielādē ātri
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronautu kaķis",
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)
Svarīgākais vārds ir pagaidu: atgrieztā URL beidzas derīguma termiņš. Lietotne, kas to saglabā datubāzē un parāda nedēļas vēlāk, saskarsies ar bojātiem attēliem, bieži vien ilgi pēc izvietošanas. Ir divi risinājumi: nekavējoties lejupielādēt attēlu no URL vai pieprasīt to tieši Base64 formātā — abos gadījumos attēlam jānonāk tavā paša krātuvē.
Pareizās kombinācijas izvēle
Katram lietojuma gadījumam lūk ieteicamās kombinācijas:
- Instagram ieraksts:
1:1, izšķirtspēja1k, Imagine 1.0 - Stāsts/Reels:
9:16, izšķirtspēja1k, Imagine 1.0 - Tīmekļa baneris:
16:9vai2:1, izšķirtspēja1k, Imagine 1.0 - Pasākuma plakāts:
3:4, izšķirtspēja2k, Imagine 2.0 armediumkvalitāti - Raksta ilustrācija:
16:9, izšķirtspēja2k, Imagine 2.0 armediumkvalitāti
Galvenās atziņas
- Pieejamas vairāk nekā 10 malu attiecības, plus
autorežīms - Divas izšķirtspējas:
1k(ātra, tīmeklim) un2k(detalizēta, drukai) - Divi atbildes formāti:
url(pagaidu) unb64_json(pastāvīgs) - Atgrieztie MIME tipi var būt PNG, JPEG vai WebP
- Pielāgo attiecību sava attēla izplatīšanas kanālam