Moderálás, SDK-inkompatibilitások és költségszabályozás
Ezen az oldalon
Frissítve: 2026. november 2. — Imagine. A
grok-imagine-image-qualitymodellt 2026. november 2-án megszüntették (a kéréseit az Imagine 2.0 szolgálja kilowminőségben): a példák most agrok-imagine-image(Imagine 1.0) és agrok-imagine-image-2.0(Imagine 2.0,low,mediumvagyautominőség) modelleket használják. Az OpenAI SDK esetén azaspect_ratio,resolutionésqualityparaméterek azextra_bodyobjektumon 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
lowminő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 arequestskö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-modelsvé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.