Generare în lot și parametrul n
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Imagine.
grok-imagine-image-qualitya fost eliminat la 2 noiembrie 2026 (cererile sale sunt acum 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,aspect_ratio,resolutionșiqualityse transmit prinextra_body, iar editarea se gestionează prin SDK-ul xAI sau o cerere HTTP.
Generarea mai multor imagini într-o singură cerere
Parametrul n din API-ul de generare vă permite să produceți până la 10 imagini dintr-un singur prompt. Fiecare imagine este o variație unică, oferindu-vă o gamă de opțiuni pentru a selecta cel mai bun rezultat sau pentru a construi o galerie vizuală.
Detalierea parametrului n
Parametrul n acceptă un număr întreg între 1 și 10, având valoarea implicită 1. Valoarea sa reală rezidă într-o proprietate a generării de imagini pe care este ușor să o uitați: rezultatul este nedeterminist. Același prompt produce imagini diferite de fiecare dată când îl apelați, iar niciuna nu este mai „corectă“ decât alta. Generarea a patru variații simultan nu este o risipă, ci recunoașterea faptului că nu știți dinainte care dintre ele va funcționa.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# Generează 5 variații
response = client.images.generate(
model="grok-imagine-image",
prompt="A zen Japanese garden with a red bridge, ukiyo-e style",
n=5,
extra_body={"aspect_ratio": "16:9", "resolution": "1k"},
)
for i, image in enumerate(response.data):
print(f"Variation {i + 1}: {image.url}")
Impactul asupra costurilor și limitelor de rată
Punctul esențial de înțeles înainte de a construi un pipeline pe această bază: n=10 nu reprezintă un discount. Plătiți pentru zece imagini și consumați zece unități din limita de rată, exact ca în cazul a zece apeluri separate. Singurul câștig este cel de rețea—o singură dus-întors în loc de zece—ceea ce ajută la latență, dar nu modifică bugetul.
| Parameter | n=1 | n=5 | n=10 |
|---|---|---|---|
| Cost (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Cost (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Images generated | 1 | 5 | 10 |
O cerere cu n=10 consumă același buget ca 10 cereri individuale cu n=1, dar este mai rapidă deoarece necesită un singur apel de rețea.
Strategii de selecție
Generarea a zece variații fără o metodă de sortare doar deplasează problema: aveați o imagine incertă, acum aveți zece imagini de judecat. Întrebarea care trebuie clarificată mai întâi este criteriul—estetic, unde ochiul uman rămâne de neînvins; sau verificabil (este produsul vizibil, este textul lizibil, este formatul respectat), caz în care automatizarea devine posibilă.
Selecție manuală
Pentru cazurile critice (publicitate, coperți de carte), descărcați toate variațiile și comparați-le vizual:
import urllib.request
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Science fiction book cover, organic spaceship",
n=8,
extra_body={"aspect_ratio": "3:4", "resolution": "2k"},
)
for i, image in enumerate(response.data):
urllib.request.urlretrieve(image.url, f"variation_{i + 1}.png")
print(f"Variation {i + 1} saved")
Selecție automatizată
Folosirea unui model de viziune pentru a judeca imaginile funcționează cu o singură condiție: criteriul trebuie să fie factual. „Conține această imagine un produs centrat pe un fundal solid?“ primește un răspuns fiabil; „care este cea mai frumoasă?“ primește un răspuns arbitrar prezentat cu încredere. Formulați criterii verificabile și păstrați judecata estetică pentru dumneavoastră.
def generate_and_select(prompt, n=5):
"""Generate n variations and return all URLs."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Generarea în lot a mai multor prompturi
Pentru a genera imagini din mai multe prompturi diferite, combinați apelurile:
prompts = [
"Illustration of a Parisian café, impressionist style",
"Aerial view of terraced rice fields, photographic style",
"Interior of an old library, dim lighting"
]
all_results = {}
for prompt in prompts:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3
)
all_results[prompt] = [img.url for img in response.data]
# 3 prompts x 3 variations = 9 images, total cost: $0.18
Descărcarea în lot
Acesta este obiceiul pe care trebuie să îl construiți de la prima linie de cod, nu atunci când implementați în producție: URL-urile expiră. Un lot de zece imagini generate dimineața și descărcate seara este un lot pierdut—și va trebui să plătiți din nou pentru el.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Download all images from a response."""
os.makedirs(output_dir, exist_ok=True)
for i, image in enumerate(response.data):
filepath = os.path.join(output_dir, f"image_{i + 1}.png")
urllib.request.urlretrieve(image.url, filepath)
print(f"{len(response.data)} images saved in {output_dir}/")
Prețuri la data de 5 august 2026 — prețurile se modifică regulat: înainte de orice calcul bugetar, verificați grila de prețuri actualizată pe pagina oficială a modelelor și prețurilor xAI.
Puncte cheie
- Parametrul
nvă permite să generați între 1 și 10 variații per cerere - Fiecare imagine se contează individual pentru facturare
- Generarea în lot (o singură cerere cu n>1) este mai rapidă decât n cereri individuale
- Descărcați rezultatele imediat deoarece URL-urile sunt temporare
- Folosiți n=3 până la 5 pentru explorare, n=1 pentru producție țintită