Proporcijos, skiriamosios gebos ir išvesties formatai
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. — Imagine. Nuo 2026 m. lapkričio 2 d.
grok-imagine-image-qualitynebeveikia (jo užklausas tvarko Imagine 2.0 sulowkokybe): pavyzdžiuose dabar naudojamigrok-imagine-image(Imagine 1.0) irgrok-imagine-image-2.0(Imagine 2.0,low,mediumarbaautokokybės). Naudojant OpenAI SDK, parametraiaspect_ratio,resolutionirqualityperduodami perextra_body, o redagavimas atliekamas naudojant xAI SDK arba HTTP užklausą.
Kaip valdyti vaizdų matmenis
Pasirinkta proporcija ir skiriamoji geba tiesiogiai lemia sugeneruotų vaizdų išvaizdą ir pritaikomumą. Grok Imagine API suteikia didelį lankstumą siūlydama daugybę iš anksto nustatytų proporcijų ir du skiriamosios gebos lygius.
Galimos proporcijos
Proporciją rinkis pagal galutinę paskirtį ir tai daryk prieš generuodamas vaizdą. Jei kvadratinį vaizdą vėliau apkirpsi į panoraminę antraštę, sugadinsi modelio sukurtą kompoziciją: objektas atsidurs ne centre, dingsta paraštės. Generuoti tiesiai į tinkamą formatą kainuoja tiek pat, o gauni vaizdą, specialiai sukurtą tam proporcijų santykiui.
| Proporcija | Orientacija | Tipiškas naudojimas |
|---|---|---|
| 1:1 | Kvadratas | Profiliai, piktogramos, Instagram |
| 16:9 | Platus kraštovaizdis | Prezentacijos, antraštės, vaizdo įrašai |
| 9:16 | Vertikalus portretas | „Stories“, „Reels“, TikTok |
| 4:3 | Klasikinis kraštovaizdis | Tradicinės nuotraukos, dokumentai |
| 3:4 | Portretas | Plakatai, knygų viršeliai |
| 3:2 / 2:3 | Standartinė nuotrauka | Nuotraukų spaudiniai, atvirukai |
| 2:1 / 1:2 | Ultra platus / ultra vertikalus | Svetainių antraštės, panoramos |
| auto | Automatinis | Modelis pasirenka optimalią proporciją |
Yra papildomų proporcijų specifiniams atvejams, pavyzdžiui, išmaniųjų telefonų ekranams: 9:19.5, 19.5:9, 9:20 ir 20:9.
Skiriamosios gebos: 1k prieš 2k
Renkantis tarp 1k ir 2k, klausimas yra ne „kuri geresnė“, o „kur šis vaizdas bus peržiūrimas“. Ekrane skirtumas daugumai interneto naudojimo atvejų yra nematomas, o 2k tik pailgina generavimo laiką. Tačiau spaudai tai tampa kritiška, nes pikselių skaičius centimetre tiesiogiai lemia matomą ryškumą.
1k: Standartinė skiriamoji geba, tinkama daugumai interneto poreikių. Greitesnis generavimas.2k: Aukšta skiriamoji geba, idealiai tinka spaudai arba vaizdams, kuriems reikia daug detalių.
# Standartinė skiriamoji geba internetui
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neoninio stiliaus mobiliosios programėlės piktograma",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Aukšta skiriamoji geba spaudai
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco koncertų plakatas su elegantiška tipografija",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Atsakymų formatai
Parametras response_format nulemia, kaip vaizdas bus grąžintas tau:
Laikinas URL (numatytasis)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronautas katinas",
response_format="url"
)
# response.data[0].url → Laikinas URL, atsisiųskite greitai
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronautas katinas",
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)
Svarbiausias žodis čia yra laikinas: grąžintas URL galioja ribotą laiką. Programėlė, kuri jį išsaugo duomenų bazėje ir rodo po kelių savaičių, susidurs su neveikiančiais vaizdais, dažnai jau po diegimo. Yra du veikiantys sprendimai: nedelsiant atsisiųsti vaizdą iš URL arba paprašyti jo tiesiai Base64 formatu – bet kuriuo atveju vaizdas turi atsidurti tavo pačio saugykloje.
Tinkamo derinio pasirinkimas
Kiekvienam naudojimui štai rekomenduojami deriniai:
- Instagram įrašas:
1:1, skiriamoji geba1k, Imagine 1.0 - „Story“/„Reel“:
9:16, skiriamoji geba1k, Imagine 1.0 - Svetainės antraštė:
16:9arba2:1, skiriamoji geba1k, Imagine 1.0 - Renginio plakatas:
3:4, skiriamoji geba2k, Imagine 2.0 sumediumkokybe - Straipsnio iliustracija:
16:9, skiriamoji geba2k, Imagine 2.0 sumediumkokybe
Svarbiausi punktai
- Prieinama daugiau nei 10 proporcijų, plius
autorežimas - Dvi skiriamosios gebos:
1k(greita, internetui) ir2k(detali, spaudai) - Du atsakymų formatai:
url(laikinas) irb64_json(ilgalaikis) - Grąžinami MIME tipai gali būti PNG, JPEG arba WebP
- Pritaikyk proporciją savo vaizdo platinimo kanalui