Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Moderácia, nekompatibility SDK a kontrola nákladov

Lekcia 14 z 14 Aktualizované 3. novembra 2026 Začiatočník
Na tejto strane
  1. Pochopte obmedzenia API pre obrázky
  2. Moderácia obsahu
  3. Nekompatibilita OpenAI SDK pri úpravách
  4. Kontrola nákladov
  5. Koncový bod na objavovanie modelov
  6. Kľúčové poznatky
  7. Otestuj si svoje vedomosti

Aktualizované 2. novembra 2026 — Imagine. Model grok-imagine-image-quality bol 2. novembra 2026 odstránený (jeho požiadavky sú teraz obsluhované modelom Imagine 2.0 v kvalite low): príklady teraz využívajú grok-imagine-image (Imagine 1.0) a grok-imagine-image-2.0 (Imagine 2.0, kvalita low, medium alebo auto). Pri používaní OpenAI SDK prechádzajú parametre aspect_ratio, resolution a quality cez extra_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žij requests
  • 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.