Moderování, nekompatibility SDK a kontrola nákladů
Na této stránce
Aktualizováno 2. listopadu 2026 — Imagine. Model
grok-imagine-image-qualitybyl 2. listopadu 2026 odstraněn (jeho požadavky jsou nyní obsluhovány modelem Imagine 2.0 v kvalitělow): příklady nyní používajígrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumneboauto). Při použití OpenAI SDK procházejí parametryaspect_ratio,resolutionaqualitypřesextra_body, zatímco úpravy vyžadují xAI SDK nebo přímý HTTP požadavek.
Pochopte limity API pro obrázky
Abys mohl s API pro generování obrázků Grok budovat spolehlivé aplikace, musíš znát jeho limity: automatické moderování, nekompatibilitu s určitými metodami OpenAI SDK a mechanismy kontroly nákladů.
Moderování obsahu
API automaticky moderuje prompty i generované obrázky. Určité typy obsahu jsou odmítnuty:
- Explicitně násilný obsah nebo gore
- Explicitně sexuální obsah
- Nenávistný nebo diskriminační obsah
- Obsah nevhodně zahrnující nezletilé
Pokud je aktivováno moderování, API vrátí chybu místo obrázku.
Zpracování odmítnutí moderováním
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Generuje obrázek se zpracováním odmítnutí moderováním."""
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 odmítnut moderováním: {prompt[:50]}...")
return None
raise
Osvědčené postupy pro moderování
V praxi řeš moderování preventivně, nikoliv reaktivně. Pokud je legitimní prompt zablokován, otestuj varianty, abys identifikoval spouštěcí slovo – fráze „epic battle“ projde tam, kde hrubší výraz neprojde, a mapování těchto citlivých míst předchází opakovaným blokacím. Když prompty pocházejí od tvých uživatelů, přidej před voláním API serverový přefiltr: zachytí zjevně nepřípustné požadavky bez spotřeby kreditu a udržuje tě v kontrole nad zobrazovanou zprávou. Právě tento poslední bod dělá rozdíl v uživatelském zážitku: blokování moderováním se nikdy nesmí uživateli zobrazit jako syrová technická chyba, ale jako jasná zpráva – „tento požadavek není v souladu s našimi podmínkami použití“ – která vysvětluje situaci, aniž by odhalovala detaily API.
Nekompatibilita OpenAI SDK pro úpravy
Toto je kritický bod: metoda images.edit() z OpenAI SDK nefunguje s xAI API. OpenAI SDK odesílá data jako multipart/form-data, zatímco xAI API očekává 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: přímé volání REST
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"}
}
)
Shrnutí kompatibility
| Operace | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Kompatibilní | Kompatibilní |
| images.edit() | Nekompatibilní | Kompatibilní |
Kontrola nákladů
Sledování spotřeby
Nastav si v kódu počítadlo výdajů:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # nízká kvalita; střední za mřížkovou sazbu
}
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"Utaceno: ${self.total_spent:.2f}")
print(f"Zbývající rozpočet: ${remaining:.2f}")
# Použití
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()
Optimalizace nákladů
Zlatým pravidlem je oddělit fázi explorace od produkce. Během hledání správného promptu pracuj s Imagine 1.0 ($0,02) a parametrem n=3-5, abys porovnal varianty za nižší cenu; jakmile je prompt stabilní, přepni se na Imagine 2.0 s n=1 pro finální render. Toto sekvenování vyhrazuje nejvyšší sazbu pouze pro vybrané obrázky.
Na straně aplikace doplňují toto nastavení dva mechanismy. Zaprvé, cache výsledků: pokud přijde stejný prompt – vizuály katalogu, standardní obrázky regenerované více uživateli – servíruj již vygenerovaný obrázek místo placení za nový požadavek. Zadruhé, kvóty, pokud generování spouští sami uživatelé: limit na den nebo hodinu chrání tvůj rozpočet před nepřiměřeným využitím a zneužitím. Nakonec sleduj limity rychlosti (standardně 300 RPM, pro verzi Pro 30 RPM): batch pipeline, která je ignoruje, nahromadí chyby 429 a zbytečné retry pokusy.
Odhad měsíčního rozpočtu
Pro aplikaci se 100 uživateli generujícími 10 obrázků denně:
- Imagine 1.0: 100 × 10 × 30 × 0,02 $ = 600 $/měsíc
- Imagine 2.0 v
low: 100 × 10 × 30 × 0,04 $ = 1 200 $/měsíc - Smíšeně (80/20): 24 000 × 0,02 $ + 6 000 × 0,04 $ = 720 $/měsíc
Koncový bod pro objevování modelů
Pro programové ověření dostupných modelů obrázků a jejich cen:
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ázek, "
f"max prompt : {model['max_prompt_length']} znaků")
Sazby k 5. srpnu 2026 – ceny se pravidelně mění: před jakýmkoli výpočtem rozpočtu zkontroluj aktuální ceník na oficiální stránce modelů a sazeb xAI.
Klíčové poznatky
- Moderování je automatické: zpracovávej odmítnutí ve svém kódu
- OpenAI SDK
images.edit()je s xAI nekompatibilní: použijrequests - OpenAI SDK
images.generate()funguje běžně - Implementuj sledovač rozpočtu pro kontrolu výdajů
- Modely a ceny ověřuj přes koncový bod
/v1/image-generation-models
Ověř si své znalosti
Generování a úpravy obrázků: operační přehled.
1. Co odlišuje Imagine 1.0 a Imagine 2.0?
Odpověď: Kompromis mezi kvalitou a cenou: Imagine 1.0 (0,02 $) pro objem a iterace, Imagine 2.0 (0,04 $ v low, s nastavením quality) pro finální rendery – prototypuješ s prvním, finalizuješ s druhým.
2. Co tvoří dobrý prompt pro obrázek?
Odpověď: Předmět, styl, kompozice a explicitní detaily – popiš scénu jako zadání pro art direction, poté iteruj s cílenými úpravami místo přepisování celého textu.
3. Co umožňuje koncový bod /v1/images/edits?
Odpověď: Úpravy existujících obrázků: editace cílená promptem, úpravy více obrázků s referencemi a vícekolové úpravy – přesně retušuješ místo opětovného generování.
4. Jak efektivně produkovat ve velkém objemu?
Odpověď: Parametr n pro dávky, asynchronní klient pro propustnost – a protože URL výstupů jsou dočasné, okamžitě stahuj a archivuj.
5. Jaká ochranná opatření před nasazením do produkce?
Odpověď: Moderování promptů i výstupů, znalost nekompatibilit SDK a kontrola nákladů (model, rozlišení, objemy) – tvorba ve velkém měřítku vyžaduje správu.
Prototypuj, upravuj, industrializuj, spravuj: kompletní pipeline pro obrázky – s náklady pod kontrolou v každém kroku.