Parametr jakości i optymalizacja renderowania
Na tej stronie
Lekcja przepisana 2 listopada 2026 r. Poprzednia wersja opisywała wartość
highoraz parametrquality, które nie miały wpływu na cenę dla modelu „pro“, który został już wycofany. Zgodnie z aktualną dokumentacją xAI,qualityjest specyficzny dla Imagine 2.0, akceptuje wartościlow,mediumiauto, a każdy obraz jest rozliczany zgodnie z jakością, w jakiej został wygenerowany.
Kontrola jakości generowania

W aplikacji Grok selektor Szybkość / Jakość balansuje między szybkością a precyzją. W API ten balans zależy od dwóch wyborów: modelu (Imagine 1.0 lub Imagine 2.0) oraz, w przypadku Imagine 2.0, parametru quality.
Parametr quality
Parametr quality jest obsługiwany przez grok-imagine-image-2.0, zarówno przy generowaniu, jak i edycji. Dostępne są trzy wartości:
low: najtańsze ustawienie dla Imagine 2.0 (0,04 USD za obraz według cennika), tutaj przekierowywane są również żądania ze starego modelu „pro“;medium: większa moc obliczeniowa na obraz dla uzyskania drobniejszych detali; zarezerwuj to dla grafik, w których jakość jest ważniejsza niż koszt;auto: wartość domyślna, gdy parametr zostanie pominięty; obecnie serwujelowprzy generowaniu imediumprzy edycji, a obraz jest rozliczany zgodnie z faktycznie użytą jakością.
Aby kontrolować zarówno renderowanie, jak i fakturę, ustaw jakość jawnie, zamiast pozwalać decydować opcji auto. Korzystając z OpenAI SDK skierowanego do API xAI, przekażesz te dane przez extra_body:
# Szybki szkic: Imagine 1.0, najtaniej
brouillon = client.images.generate(
model="grok-imagine-image",
prompt="E-commerce website mockup, wireframe style",
)
# Standardowa grafika: Imagine 2.0, niska jakość
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration of a mobile fitness app",
extra_body={"quality": "low"},
)
# Grafika finalna: Imagine 2.0, średnia jakość, rozdzielczość 2k
final = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Advertising poster for a luxury perfume, photorealistic render",
extra_body={"quality": "medium", "resolution": "2k"},
)
Kombinacja model + quality + resolution
Trzy parametry, trzy efekty: model ustala cenę bazową i dostępne funkcje, quality określa poziom szczegółowości dla Imagine 2.0 (i jego stawkę), a resolution definiuje rozdzielczość obrazu (domyślnie 1k lub 2k).
| Przypadek użycia | Model | Jakość | Rozdzielczość |
|---|---|---|---|
| Szybki prototyp | Imagine 1.0 | — | 1k |
| Treści do sieci | Imagine 1.0 | — | 1k |
| Media społecznościowe | Imagine 2.0 | low | 1k |
| Materiał marketingowy | Imagine 2.0 | medium | 1k |
| Druk, plakat | Imagine 2.0 | medium | 2k |
3-etapowy proces optymalizacji
Znajdź właściwy pomysł tam, gdzie jest tanio, dopracuj go, a za najdroższy render zapłać tylko dla wybranego obrazu.
Krok 1: Eksploracja
prompts_candidats = [
"A robot barista making coffee, cartoon style",
"A robotic arm pouring coffee, realistic style",
"A mechanical hand holding a steaming cup, steampunk style",
]
for prompt in prompts_candidats:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3,
)
# Koszt: 3 x 0,02 USD = 0,06 USD za prompt
Krok 2: Dopracowanie
best_prompt = "A robotic arm pouring coffee, realistic style"
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt,
n=4,
extra_body={"quality": "low", "resolution": "1k"},
)
# Koszt: 4 x 0,04 USD = 0,16 USD
Krok 3: Finalizacja
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt + ", cinematic lighting, fine mechanical details",
n=2,
extra_body={"quality": "medium", "resolution": "2k"},
)
# Koszt: 2 obrazy według bieżącej stawki „medium“
Dwa pierwsze kroki kosztują 0,34 USD za dziewięć szkiców i cztery warianty; tylko dwa finalne obrazy są rozliczane według stawki medium.
Automatyzacja wyboru jakości
Scentralizuj ten wybór w funkcji, aby uniknąć rozproszenia logiki po całym kodzie. Jeśli stawki ulegną zmianie lub dodany zostanie nowy model, modyfikacji wymaga tylko jedno miejsce.
CONFIGS = {
"prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
"marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
"print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}
def generate_smart(prompt, usage="web"):
"""Generuje obraz z parametrami dostosowanymi do przypadku użycia."""
config = CONFIGS.get(usage, CONFIGS["web"])
return client.images.generate(prompt=prompt, **config)
Źródła oficjalne: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing
Kluczowe wnioski
qualityjest specyficzny dla Imagine 2.0 i akceptuje wartościlow,mediumorazauto(wartość domyślna)- Obraz jest rozliczany zgodnie z użytą jakością: ustaw jakość jawnie, aby kontrolować koszty
- W OpenAI SDK parametry
qualityiresolutionprzekazuje się przezextra_body - Proces 3-etapowy: eksploruj z Imagine 1.0, dopracuj w
low, sfinalizuj wmedium - Scentralizuj wybór parametrów w funkcji konfiguracyjnej