Rapoarte de aspect, rezoluții și formate de ieșire
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Imagine.
grok-imagine-image-qualitya fost eliminat începând cu 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 în calitatelow): exemplele folosesc acumgrok-imagine-image(Imagine 1.0) șigrok-imagine-image-2.0(Imagine 2.0, calitatelow,mediumsauauto). Cu SDK-ul OpenAI, parametriiaspect_ratio,resolutionșiqualityse transmit prinextra_body, iar editarea se face prin SDK-ul xAI sau o cerere HTTP.
Stăpânirea dimensiunilor imaginii
Raportul de aspect și rezoluția pe care le alegeți determină direct aspectul și utilitatea imaginilor generate. API-ul Grok Imagine oferă o flexibilitate semnificativă, cu numeroase rapoarte predefinite și două niveluri de rezoluție.
Rapoarte de aspect disponibile
Alegeți raportul în funcție de destinație și faceți această alegere înainte de generare. Decuparea unei imagini pătrate pentru a obține un banner panoramic după generare distruge compoziția pe care modelul a construit-o pentru un pătrat: subiectul ajunge decalat, marginile dispar. Generarea direct în formatul corect costă la fel și vă oferă o imagine concepută special pentru proporțiile sale.
| Raport | Orientare | Utilizare tipică |
|---|---|---|
| 1:1 | Pătrat | Profile, iconițe, Instagram |
| 16:9 | Peisaj larg | Prezentări, bannere, video |
| 9:16 | Portret vertical | Stories, Reels, TikTok |
| 4:3 | Peisaj clasic | Fotografii tradiționale, documente |
| 3:4 | Portret | Afișe, coperți de carte |
| 3:2 / 2:3 | Foto standard | Imprimări foto, cărți poștale |
| 2:1 / 1:2 | Ultra larg / ultra vertical | Bannere web, panorame |
| auto | Automat | Modelul alege raportul optim |
Sunt disponibile și rapoarte suplimentare pentru cazuri specifice, cum ar fi ecranele smartphone-urilor: 9:19.5, 19.5:9, 9:20 și 20:9.
Rezoluții: 1k față de 2k
Între 1k și 2k, întrebarea nu este „care este mai bun“, ci „unde va fi vizualizată această imagine“. Pe un ecran, diferența este invizibilă pentru marea majoritate a utilizărilor web, iar 2k costă doar timp suplimentar de generare. Devine însă critic pentru tipărituri, unde numărul de pixeli pe centimetru determină direct claritatea percepută.
1k: Rezoluție standard, potrivită pentru majoritatea utilizărilor web. Timp de generare mai rapid.2k: Rezoluție înaltă, ideală pentru tipărituri sau elemente vizuale care necesită multe detalii.
# Rezoluție standard pentru web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Iconiță aplicație mobilă în stil neon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Rezoluție înaltă pentru tipărituri
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Afiș concert Art Deco cu tipografie elegantă",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Formate de răspuns
Parametrul response_format determină modul în care imaginea vă este returnată:
URL temporar (Implicit)
response = client.images.generate(
model="grok-imagine-image",
prompt="Pisică astronaut",
response_format="url"
)
# response.data[0].url → URL temporar, descărcați rapid
JSON Base64
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Pisică astronaut",
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)
Cuvântul important este temporar: URL-ul returnat expiră. O aplicație care îl stochează într-o bază de date și îl afișează săptămâni mai târziu va întâlni imagini rupte, adesea mult după lansare. Două opțiuni funcționează: descărcați imaginea de la URL imediat sau solicitați direct Base64; în ambele cazuri, imaginea trebuie să ajungă pe stocarea dumneavoastră proprie.
Alegerea combinației potrivite
Pentru fiecare caz de utilizare, iată combinațiile recomandate:
- Postare Instagram:
1:1, rezoluție1k, Imagine 1.0 - Story/Reel:
9:16, rezoluție1k, Imagine 1.0 - Banner Web:
16:9sau2:1, rezoluție1k, Imagine 1.0 - Afiș eveniment:
3:4, rezoluție2k, Imagine 2.0 în calitatemedium - Ilustrație articol:
16:9, rezoluție2k, Imagine 2.0 în calitatemedium
Puncte cheie
- Peste 10 rapoarte de aspect disponibile, plus modul
auto - Două rezoluții:
1k(rapid, web) și2k(detaliat, tipăritură) - Două formate de răspuns:
url(temporar) șib64_json(persistent) - Tipurile MIME returnate pot fi PNG, JPEG sau WebP
- Adaptați raportul la canalul de distribuție al imaginii dumneavoastră