Moderácia, nekompatibility SDK a kontrola nákladov
Na tejto strane
Aktualizované 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualitybol 2. novembra 2026 odstránený (jeho požiadavky sú teraz obsluhované modelom Imagine 2.0 v kvalitelow): príklady teraz využívajúgrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumaleboauto). Pri používaní OpenAI SDK prechádzajú parametreaspect_ratio,resolutionaqualitycezextra_body, zatiaľ čo úpravy obrázkov vyžadujú xAI SDK alebo priamy HTTP požiadavok.
Pochopte obmedzenia API pre obrázky
Aby ste mohli budovať spoľahlivé aplikácie s API na generovanie obrázkov Grok, musíte poznať jeho obmedzenia: automatickú moderáciu, nekompatibilitu s určitými metódami OpenAI SDK a mechanizmy kontroly nákladov.
Moderácia obsahu
API automaticky moderuje prompty aj generované obrázky. Určité typy obsahu sú odmietnuté:
- Explicitne násilný obsah alebo gore
- Explicitne sexuálny obsah
- Nenávistný alebo diskriminačný obsah
- Obsah nevhodne zahŕňajúci neplnoleté osoby
Keď sa spustí moderácia, API vráti chybu namiesto obrázka.
Spracovanie odmietnutí moderáciou
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Generuje obrázok so spracovaním odmietnutí moderáciou."""
try:
response = requests.post(
"https://api.x.ai/v1/images/generations",
headers=headers,
json={"model": "grok-imagine-image", "prompt": prompt, **kwargs}
)
response.raise_for_status()
return response.json()["data"][0]["url"]
except requests.exceptions.HTTPError as e:
if response.status_code == 400:
print(f"Prompt odmietnutý moderáciou: {prompt[:50]}...")
return None
raise
Osvedčené postupy pri moderácii
V praxi rieš moderáciu preventívne, nie až reakčne. Ak je legitímny prompt zablokovaný, otestuj variácie, aby si identifikoval spúšťacie slovo – fráza „epická bitka“ prejde tam, kde hrubší výraz nie, a zmapovanie týchto citlivých miest predchádza opakovaným blokádam. Keď prompty pochádzajú od tvojich používateľov, pridaj pred volaním API serverový predfilter: zachytí zjavne neprijateľné požiadavky bez spotrebovania kreditu a udržia ťa pod kontrolou nad zobrazovanou správou. Práve tento posledný bod robí rozdiel v používateľskej skúsenosti: blokácia moderáciou by sa nikdy nemala dostať k používateľovi ako surová technická chyba, ale ako jasná správa – „táto požiadavka nie je v súlade s našimi podmienkami používania“ – ktorá vysvetľuje situáciu bez odhaľovania detailov API.
Nekompatibilita OpenAI SDK pri úpravách
Toto je kritický bod: metóda images.edit() z OpenAI SDK nefunguje s xAI API. OpenAI SDK odosiela dáta ako multipart/form-data, zatiaľ čo xAI API očakáva application/json.
# NEFUNGUJE
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
client.images.edit(
model="grok-imagine-image",
image=open("photo.png", "rb"),
prompt="Edit this image"
)
# → Chyba Content-type!
# FUNGUJE: priamy REST volanie
import requests
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers={
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
},
json={
"model": "grok-imagine-image",
"prompt": "Edit this image",
"image": {"url": "https://exemple.com/photo.jpg"}
}
)
Zhrnutie kompatibility
| Operácia | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Kompatibilné | Kompatibilné |
| images.edit() | Nekompatibilné | Kompatibilné |
Kontrola nákladov
Monitorovanie spotreby
Nastav si v kóde počítadlo výdavkov:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # nízka kvalita; stredná podľa sadzobníka
}
def __init__(self, budget_limit=10.0):
self.total_spent = 0.0
self.budget_limit = budget_limit
self.image_count = 0
def can_generate(self, model, n=1):
cost = self.PRICES[model] * n
return (self.total_spent + cost) <= self.budget_limit
def record(self, model, n=1):
cost = self.PRICES[model] * n
self.total_spent += cost
self.image_count += n
def report(self):
remaining = self.budget_limit - self.total_spent
print(f"Vygenerované obrázky: {self.image_count}")
print(f"Minuté: ${self.total_spent:.2f}")
print(f"Zostávajúci rozpočet: ${remaining:.2f}")
# Použitie
tracker = ImageBudgetTracker(budget_limit=5.0)
if tracker.can_generate("grok-imagine-image", n=5):
response = client.images.generate(
model="grok-imagine-image",
prompt="My image",
n=5
)
tracker.record("grok-imagine-image", n=5)
tracker.report()
Optimalizácia nákladov
Zlatým pravidlom je oddeliť fázu explorácie od produkcie. Počas hľadania vhodného promptu pracuj s Imagine 1.0 (0,02 $) a nastav n=3-5, aby si porovnal variácie za nižšiu cenu; keď je prompt stabilný, prepni sa na Imagine 2.0 s n=1 pre finálny render. Toto postupovanie vyhradzuje najvyššiu sadzbu len pre vybrané obrázky.
Dva mechanizmy dopĺňajú nastavenie na strane aplikácie. Po prvé, cache výsledkov: ak sa vráti rovnaký prompt – vizuály katalógu, štandardné obrázky regenerované viacerými používateľmi – obslúž už vygenerovaný obrázok namiesto platby za novú požiadavku. Potom kvóty, ak generovanie spúšťajú sami používatelia: limit na deň alebo hodinu chráni tvoj rozpočet pred neprimeraným využitím a zneužívaním. Nakoniec sleduj limity rýchlosti (štandardne 300 RPM, pro verzia 30 RPM): batch pipeline, ktorá ich ignoruje, nahromadí chyby 429 a zbytočné opakovania.
Odhad mesačného rozpočtu
Pre aplikáciu so 100 používateľmi generujúcimi 10 obrázkov denne:
- Imagine 1.0: 100 × 10 × 30 × 0,02 $ = 600 $/mesiac
- Imagine 2.0 v
low: 100 × 10 × 30 × 0,04 $ = 1 200 $/mesiac - Kombinované (80/20): 24 000 × 0,02 $ + 6 000 × 0,04 $ = 720 $/mesiac
Koncový bod na objavovanie modelov
Na programové overenie dostupných modelov obrázkov a ich cien:
response = requests.get(
"https://api.x.ai/v1/image-generation-models",
headers={"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}"}
)
for model in response.json()["data"]:
print(f"{model['id']} : ${model['image_price']}/obrázok, "
f"max dĺžka promptu: {model['max_prompt_length']} znakov")
Sadzby platné k 5. augustu 2026 – ceny sa pravidelne menia: pred akýmkoľvek výpočtom rozpočtu si over aktuálny cenník na oficiálnej stránke modelov a sadzieb xAI.
Kľúčové poznatky
- Moderácia je automatická: spracuj odmietnutia vo svojom kóde
- OpenAI SDK
images.edit()je nekompatibilné s xAI: použijrequests - OpenAI SDK
images.generate()funguje bežne - Implementuj sledovač rozpočtu na kontrolu výdavkov
- Modely a ceny overuj cez koncový bod
/v1/image-generation-models
Otestuj si svoje vedomosti
Generovanie a úprava obrázkov: operatívny prehľad.
1. Čo odlišuje Imagine 1.0 a Imagine 2.0?
Odpoveď: Kompromis medzi kvalitou a cenou: Imagine 1.0 (0,02 $) pre objem a iterácie, Imagine 2.0 (0,04 $ v low, s nastavením quality) pre finálne rendery – prototypuješ s prvým, finalizuješ s druhým.
2. Čo tvorí dobrý prompt pre obrázok?
Odpoveď: Predmet, štýl, kompozícia a explicitné detaily – opíš scénu ako brief pre umeleckého vedúceho, potom iteruj cielenými úpravami namiesto prepisovania celého textu.
3. Čo umožňuje koncový bod /v1/images/edits?
Odpoveď: Úpravu existujúcich obrázkov: cielené úpravy podľa promptu, úpravy viacerých obrázkov s referenciami a viac-krokové úpravy – presne retušuješ namiesto regenerovania.
4. Ako efektívne produkovať vo veľkom objeme?
Odpoveď: Parameter n pre dávky, async klient pre priepustnosť – a keďže URL výstupov sú dočasné, okamžite ich sťahuj a archivuj.
5. Aké ochranné opatrenia pred nasadením do produkcie?
Odpoveď: Moderácia promptov a výstupov, znalosť nekompatibilít SDK a kontrola nákladov (model, rozlíšenie, objemy) – tvorba vo veľkom meradle si vyžaduje riadenie.
Prototypuj, upravuj, industrializuj, riad: kompletný pipeline pre obrázky – s nákladmi pod kontrolou v každom kroku.