Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Moderování, nekompatibility SDK a kontrola nákladů

Lekce 14 z 14 Aktualizováno 3. listopadu 2026 Začátečník
Na této stránce
  1. Pochopte limity API pro obrázky
  2. Moderování obsahu
  3. Nekompatibilita OpenAI SDK pro úpravy
  4. Kontrola nákladů
  5. Koncový bod pro objevování modelů
  6. Klíčové poznatky
  7. Ověř si své znalosti

Aktualizováno 2. listopadu 2026 — Imagine. Model grok-imagine-image-quality byl 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) a grok-imagine-image-2.0 (Imagine 2.0, kvalita low, medium nebo auto). Při použití OpenAI SDK procházejí parametry aspect_ratio, resolution a quality přes extra_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žij requests
  • 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.