Salt la conținutul principal
Română— Alege o limbă
Meniu

Rapoarte de aspect, rezoluții și formate de ieșire

Lecția 3 din 14 Actualizată 2 noiembrie 2026 Începător
Pe această pagină
  1. Stăpânirea dimensiunilor imaginii
  2. Rapoarte de aspect disponibile
  3. Rezoluții: 1k față de 2k
  4. Formate de răspuns
  5. Alegerea combinației potrivite
  6. Puncte cheie

Actualizat pe 2 noiembrie 2026 — Imagine. grok-imagine-image-quality a fost eliminat începând cu 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 în calitate low): exemplele folosesc acum grok-imagine-image (Imagine 1.0) și grok-imagine-image-2.0 (Imagine 2.0, calitate low, medium sau auto). Cu SDK-ul OpenAI, parametrii aspect_ratio, resolution și quality se transmit prin extra_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ție 1k, Imagine 1.0
  • Story/Reel: 9:16, rezoluție 1k, Imagine 1.0
  • Banner Web: 16:9 sau 2:1, rezoluție 1k, Imagine 1.0
  • Afiș eveniment: 3:4, rezoluție 2k, Imagine 2.0 în calitate medium
  • Ilustrație articol: 16:9, rezoluție 2k, Imagine 2.0 în calitate medium

Puncte cheie

  • Peste 10 rapoarte de aspect disponibile, plus modul auto
  • Două rezoluții: 1k (rapid, web) și 2k (detaliat, tipăritură)
  • Două formate de răspuns: url (temporar) și b64_json (persistent)
  • Tipurile MIME returnate pot fi PNG, JPEG sau WebP
  • Adaptați raportul la canalul de distribuție al imaginii dumneavoastră