Moderacija, nezdružljivosti SDK-jev in nadzor stroškov
Na tej strani
Posodobljeno 2. novembra 2026 — Imagine.
grok-imagine-image-qualityje bil 2. novembra 2026 odstranjen (njegove zahteve zdaj obravnava Imagine 2.0 v kakovostilow): primeri zdaj uporabljajogrok-imagine-image(Imagine 1.0) ingrok-imagine-image-2.0(Imagine 2.0, kakovostlow,mediumaliauto). Pri uporabi OpenAI SDK parametriaspect_ratio,resolutioninqualitypotujejo prekoextra_body, urejanje slik pa poteka prek xAI SDK ali neposrednega HTTP zahtevka.
Razumevanje omejitev API-ja za slike
Če želiš zgraditi zanesljive aplikacije z API-jem za generiranje slik Grok, moraš poznati njegove omejitve: samodejno moderacijo, nezdružljivost z določenimi metodami OpenAI SDK in mehanizme za nadzor stroškov.
Moderacija vsebine
API samodejno moderira pozive in generirane slike. Določene vrste vsebine so zavrnjene:
- Izrecno nasilna ali krvava vsebina
- Izrecno spolna vsebina
- Sovražna ali diskriminatorna vsebina
- Vsebina, ki neprimerno vključuje mladoletnike
Ko se sproži moderacija, API namesto slike vrne napako.
Obravnava zavrnitev zaradi moderacije
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Generiraj sliko ob hkratni obravnavi zavrnitev zaradi moderacije."""
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"Poziv je zavrnila moderacija: {prompt[:50]}...")
return None
raise
Najboljše prakse pri moderaciji
V praksi moderacijo obravnavaj preventivno, ne reaktivno. Če je legitimen poziv blokiran, preizkusi različice, da identificiraš sprožilno besedo – „epic battle” bo šlo skozi, medtem ko bolj grob izraz ne bo, in mapiranje teh občutljivosti prepreči ponavljajoče se blokade. Ko pozive vnašajo tvoji uporabniki, dodaj strežniški predfilter pred klicem API-ja: ta prestreže očitno nedovoljene zahteve, ne da bi porabil zahtevek, in ti omogoča nadzor nad prikazanim sporočilom. Prav ta zadnja točka namreč naredi razliko v uporabniški izkušnji: blokada zaradi moderacije se uporabniku nikoli ne sme prikazati kot surova tehnična napaka, temveč kot jasno sporočilo – „ta zahteva ni v skladu z našimi pogoji uporabe” – ki pojasni situacijo, ne da bi razkrivalo podrobnosti API-ja.
Nezdružljivost OpenAI SDK za urejanje
To je ključna točka: metoda images.edit() v OpenAI SDK ne deluje z xAI API-jem. OpenAI SDK pošilja podatke kot multipart/form-data, medtem ko xAI API pričakuje application/json.
# NE DELUJE
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"
)
# → Napaka Content-type!
# DELUJE: neposreden klic 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"}
}
)
Povzetek združljivosti
| Operacija | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Združljivo | Združljivo |
| images.edit() | Nezdružljivo | Združljivo |
Nadzor stroškov
Spremljanje porabe
V svojo kodo nastavi števec porabe:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # nizka kakovost; srednja po ceniku
}
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"Generirane slike: {self.image_count}")
print(f"Porabljeno: ${self.total_spent:.2f}")
print(f"Preostali proračun: ${remaining:.2f}")
# Uporaba
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()
Optimizacija stroškov
Zlato pravilo je ločevanje raziskovanja in produkcije. Med iskanjem ustreznega poziva delaj z Imagine 1.0 (0,02 $) z n=3-5, da primerjaš variacije po nižji ceni; ko je poziv stabilen, preklopi na Imagine 2.0 z n=1 za končni izris. To zaporedje rezervira najvišjo ceno le za izbrane slike.
Na strani aplikacije postavitev dopolnjujeta še dva mehanizma. Prvi je predpomnilnik rezultatov: če se isti poziv ponovi – vizuali kataloga, standardne slike, ki jih regenerirajo različni uporabniki – postreži že generirano sliko namesto plačila novega zahtevka. Drugi so kvote, če generiranje sprožajo tvoji uporabniki: omejitev na dan ali uro ščiti tvoj proračun pred nerazumno uporabo in zlorabami. Nazadnje, bodi pozoren na omejitve hitrosti (standardno 300 RPM, profesionalno 30 RPM): cevovod za serijsko obdelavo, ki jih ignorira, kopiči napake 429 in nepotrebne ponovne poskuse.
Ocena mesečnega proračuna
Za aplikacijo s 100 uporabniki, ki generirajo 10 slik na dan:
- Imagine 1.0: 100 × 10 × 30 × 0,02 $ = 600 $/mesec
- Imagine 2.0 v
low: 100 × 10 × 30 × 0,04 $ = 1.200 $/mesec - Mešano (80/20): 24.000 × 0,02 $ + 6.000 × 0,04 $ = 720 $/mesec
Končna točka za odkrivanje modelov
Za programsko preverjanje razpoložljivih modelov slik in njihovih 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']}/slika, "
f"najv. poziv : {model['max_prompt_length']} znakov")
Cene veljajo od 5. avgusta 2026 – cene se redno spreminjajo: pred vsakim izračunom proračuna preveri trenutni cenik na uradni strani modelov in cen xAI.
Ključne ugotovitve
- Moderacija je samodejna: v svoji kodi obravnavaj zavrnitve
- OpenAI SDK
images.edit()ni združljiv z xAI: uporabirequests - OpenAI SDK
images.generate()deluje normalno - Implementiraj sledilnik proračuna za nadzor stroškov
- Preveri modele in cene preko končne točke
/v1/image-generation-models
Preveri svoje znanje
Generiranje in urejanje slik: operativni pregled.
1. Kaj razlikuje Imagine 1.0 in Imagine 2.0?
Odgovor: Razmerje med kakovostjo in stroški: Imagine 1.0 (0,02 $) za obsežnost in iteracije, Imagine 2.0 (0,04 $ v low, z nastavitvijo quality) za končne izrise – prototipiraš s prvim, finaliziraš z drugim.
2. Kaj sestavlja dober poziv za sliko?
Odgovor: Subjekt, slog, kompozicija in eksplicitne podrobnosti – sceno opiši kot navodila za umetniško vodenje, nato iteriraj s ciljnimi prilagoditvami namesto prepisovanja.
3. Kaj omogoča končna točka /v1/images/edits?
Odgovor: Urejanje obstoječih slik: urejanje, usmerjeno s pozivom, urejanje več slik z referencami in urejanje v več korakih – natančno retuširaš namesto ponovnega generiranja.
4. Kako učinkovito proizvajati v velikem obsegu?
Odgovor: Parameter n za serije, asinhroni odjemalec za prepustnost – in ker so izhodni URL-ji začasni, slike takoj prenesi in arhiviraj.
5. Kakšne varovalke so potrebne pred produkcijo?
Odgovor: Moderacija pozivov in izhodov, poznavanje nezdružljivosti SDK-jev in nadzor stroškov (model, ločljivost, količine) – ustvarjanje v obsegu zahteva upravljanje.
Prototipiraj, urejaj, industrializiraj, upravljaj: celoten cevovod za slike – s stroški pod nadzorom na vsakem koraku.