Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Moderálás, SDK-inkompatibilitások és költségszabályozás

14. lecke 14 közül Frissítve 2026. november 3. Kezdő
Ezen az oldalon
  1. Ismerd meg a kép API korlátait
  2. Tartalommoderálás
  3. Inkompatibilitás az OpenAI SDK-val szerkesztés esetén
  4. Költségszabályozás
  5. Modell-felderítő végpont
  6. Főbb megállapítások
  7. Teszteld a tudásod

Frissítve: 2026. november 2. — Imagine. A grok-imagine-image-quality modellt 2026. november 2-án megszüntették (a kéréseit az Imagine 2.0 szolgálja ki low minőségben): a példák most a grok-imagine-image (Imagine 1.0) és a grok-imagine-image-2.0 (Imagine 2.0, low, medium vagy auto minőség) modelleket használják. Az OpenAI SDK esetén az aspect_ratio, resolution és quality paraméterek az extra_body objektumon keresztül jutnak el, míg a szerkesztéshez az xAI SDK-t vagy közvetlen HTTP-kérést kell használnod.

Ismerd meg a kép API korlátait

Hogy megbízható alkalmazásokat építs a Grok képgeneráló API-val, ismerned kell a korlátait: az automatikus moderálást, bizonyos OpenAI SDK-módszerekkel való inkompatibilitást és a költségszabályozási mechanizmusokat.

Tartalommoderálás

Az API automatikusan moderálja a promptokat és a generált képeket. Bizonyos tartalomtípusokat visszautasít:

  • Kifejezetten erőszakos vagy véres tartalom
  • Kifejezetten szexuális tartalom
  • Gyűlöletkeltő vagy diszkriminatív tartalom
  • Kiskorúakat nem megfelelő módon érintő tartalom

Ha a moderálás beindul, az API kép helyett hibát ad vissza.

Moderációs visszautasítások kezelése

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

def generate_safe(prompt, **kwargs):
    """Kép generálása a moderációs visszautasítások kezelésével."""
    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"A moderálás visszautasította a promptot: {prompt[:50]}...")
            return None
        raise

Moderációs legjobb gyakorlatok

A gyakorlatban a moderációt proaktívan, ne reaktívan kezeld. Ha egy legitim promptot blokkolnak, tesztelj variációkat a kiváltó szó azonosításához – az „epikus csata“ átmegy, míg egy durvább kifejezés nem, és ezen érzékenységek feltérképezése megelőzi az ismétlődő blokkolásokat. Ha a promptok a felhasználóidtól érkeznek, adj hozzá egy szerveroldali előszűrőt az API-hívás előtt: ez elfogja a nyilvánvalóan szabályzatellenes kéréseket anélkül, hogy elhasználna egy kérést, és nálad tartja a kontrollt a megjelenített üzenet felett. Mert ez utóbbi pont teszi meg a különbséget a felhasználói élményben: egy moderációs blokknak soha nem szabad nyers technikai hibaként megjelennie a felhasználó előtt, hanem egy világos üzenetként – „ez a kérés nem felel meg a használati feltételeinknek“ –, ami magyaráz anélkül, hogy felfedné az API részleteit.

Inkompatibilitás az OpenAI SDK-val szerkesztés esetén

Ez egy kritikus pont: az OpenAI SDK images.edit() módszere nem működik az xAI API-val. Az OpenAI SDK multipart/form-data formátumban küldi az adatokat, míg az xAI API az application/json-t várja.

# NEM MŰKÖDIK
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"
)
# → Content-type hiba!

# MŰKÖDIK: közvetlen REST hívás
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"}
    }
)

Kompatibilitási összefoglaló

Művelet OpenAI SDK REST (requests)
images.generate() Kompatibilis Kompatibilis
images.edit() Inkompatibilis Kompatibilis

Költségszabályozás

Fogyasztás monitorozása

Állíts be egy költésszámlálót a kódodban:

class ImageBudgetTracker:
    PRICES = {
        "grok-imagine-image": 0.02,
        "grok-imagine-image-2.0": 0.04,  # low minőség; medium rácsárnyalaton
    }

    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"Generált képek: {self.image_count}")
        print(f"Elköltve: ${self.total_spent:.2f}")
        print(f"Fennmaradó keret: ${remaining:.2f}")

# Használat
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()

Költségek optimalizálása

Az aranyszabály: válaszd szét a felfedezést és a gyártást. A prompt-keresés során dolgozz az Imagine 1.0-val ($0,02), n=3-5 értékkel, hogy alacsonyabb költséggel hasonlítsd össze a variációkat; ha a prompt stabil, válts az Imagine 2.0-ra n=1 értékkel a végső rendereléshez. Ez a szekvencia biztosítja, hogy a legmagasabb díjat csak a kiválasztott képekre fizesd ki.

Két mechanizmus egészíti ki a beállítást az alkalmazás oldalán. Először is, egy eredmény-gyorsítótár: ha ugyanaz a prompt ismétlődik – katalógusvizuálok, szabványos képek, amelyeket több felhasználó is generáltat –, szolgáld ki a már generált képet újabb kérés fizetése helyett. Aztán a kvóták, ha a felhasználóid maguk indítják a generálásokat: egy napi vagy óránkénti korlát megvédi a költségkeretedet az ésszerűtlen használattól és visszaélésektől. Végül, figyeld a sebességkorlátokat (300 RPM standard, 30 RPM pro): egy kötegelt pipeline, amely figyelmen kívül hagyja ezeket, felhalmozza a 429-es hibákat és a felesleges újrapróbálkozásokat.

Havi költségbecslés

Egy olyan alkalmazás esetén, ahol 100 felhasználó naponta 10 képet generál:

  • Imagine 1.0: 100 × 10 × 30 × $0,02 = $600/hó
  • Imagine 2.0 low minőségben: 100 × 10 × 30 × $0,04 = $1200/hó
  • Vegyes (80/20): 24 000 × $0,02 + 6000 × $0,04 = $720/hó

Modell-felderítő végpont

A rendelkezésre álló képmodellek és áraik programozott ellenőrzéséhez:

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']}/kép, "
          f"max prompt : {model['max_prompt_length']} karakter")

Árak 2026. augusztus 5-i állapot szerint – az árak rendszeresen változnak: bármilyen költségvetés-számítás előtt ellenőrizd az aktuális díjszabást a hivatalos xAI modell- és árlapon.

Főbb megállapítások

  • A moderálás automatikus: kezeld a visszautasításokat a kódodban
  • Az OpenAI SDK images.edit() inkompatibilis az xAI-val: használd a requests könyvtárat
  • Az OpenAI SDK images.generate() normálisan működik
  • Implementálj egy költségkövetőt a kiadások kontrollálásához
  • Ellenőrizd a modelleket és árakat a /v1/image-generation-models végponton keresztül

Teszteld a tudásod

Képgenerálás és -szerkesztés: az operatív áttekintés.

1. Mi különbözteti meg az Imagine 1.0-t az Imagine 2.0-tól?

Válasz: A minőség/költség kompromisszum: az Imagine 1.0 ($0,02) a volumenre és iterációkra, az Imagine 2.0 ($0,04 low minőségben, quality beállítással) a végső renderelésre szolgál – az elsővel prototipizálsz, a másodikkal véglegesítesz.

2. Mitől jó egy képprompt?

Válasz: Tárgy, stílus, kompozíció és explicit részletek – írd le a jelenetet mint egy művészeti briefet, majd célzott finomhangolásokkal iterálj, ne teljes átírással.

3. Mire szolgál a /v1/images/edits végpont?

Válasz: Meglévő képek szerkesztésére: prompt-alapú célzott szerkesztés, többképes szerkesztés referenciákkal és többmenetes szerkesztés – pontosan retusálsz ahelyett, hogy újragenerálnál.

4. Hogyan gyárts hatékonyan nagy volumenben?

Válasz: Az n paraméter kötegeléshez, az aszinkron kliens az átviteli sebességhez – és mivel a kimeneti URL-ek ideiglenesek, azonnal töltsd le és archiváld őket.

5. Milyen biztonsági intézkedések kellenek élesítés előtt?

Válasz: A promptok és kimenetek moderálása, az SDK-inkompatibilitások ismerete és a költségszabályozás (modell, felbontás, volumen) – a nagy léptékű alkotás irányítást igényel.

Prototipizálás, szerkesztés, iparosítás, irányítás: a teljes képfolyamat – a költségek minden lépésben kontroll alatt.