Moderacija, nekompatibilnosti SDK-a i kontrola troškova
Na ovoj stranici
Ažurirano 2. studenoga 2026. — Imagine.
grok-imagine-image-qualityuklonjen je 2. studenoga 2026. (njegovi se zahtjevi obrađuju putem Imagine 2.0 ulowkvaliteti): primjeri sada koristegrok-imagine-image(Imagine 1.0) igrok-imagine-image-2.0(Imagine 2.0, kvalitetalow,mediumiliauto). Kod OpenAI SDK-a, parametriaspect_ratio,resolutioniqualityprosljeđuju se krozextra_body, dok se uređivanje vrši putem xAI SDK-a ili izravnim HTTP zahtjevom.
Razumijevanje ograničenja API-ja za slike
Da bi izgradio pouzdane aplikacije s Grok API-jem za generiranje slika, moraš poznavati njegova ograničenja: automatsku moderaciju, nekompatibilnost s određenim metodama OpenAI SDK-a i mehanizme kontrole troškova.
Moderacija sadržaja
API automatski moderira upite (prompte) i generirane slike. Određene vrste sadržaja se odbijaju:
- Eksplicitno nasilan sadržaj ili prikazi krvi
- Eksplicitno seksualni sadržaj
- Sadržaj koji potiče mržnju ili diskriminaciju
- Sadržaj koji na neodgovarajući način uključuje maloljetnike
Kada se aktivira moderacija, API vraća pogrešku umjesto slike.
Rukovanje odbijanjima zbog moderacije
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Generiraj sliku uz rukovanje odbijanjima zbog 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"Upit odbijen od strane moderacije: {prompt[:50]}...")
return None
raise
Najbolje prakse za moderaciju
U praksi, moderaciju rješavaj preventivno, a ne reaktivno. Ako je legitiman upit blokiran, testiraj varijacije kako bi identificirao okidačku riječ—„epic battle“ će proći tamo gdje grublji izraz neće, a mapiranje ovih osjetljivosti izbjegava ponavljajuća blokiranja. Kada upite šalju tvoji korisnici, dodaj serverski predfilter prije poziva API-ju: on presreće očito nedopuštene zahtjeve bez trošenja kredita za zahtjev i zadržava te pod kontrolom poruke koja se prikazuje. Jer upravo ta zadnja točka čini razliku u iskustvu: blokiranje zbog moderacije nikada ne smije stići do korisnika kao sirova tehnička pogreška, već kao jasna poruka—„ovaj zahtjev nije u skladu s našim uvjetima korištenja“—koja objašnjava situaciju bez otkrivanja detalja API-ja.
Nekompatibilnost OpenAI SDK-a za uređivanje
Ovo je ključna točka: metoda images.edit() iz OpenAI SDK-a ne radi s xAI API-jem. OpenAI SDK šalje podatke kao multipart/form-data, dok xAI API očekuje application/json.
# NE RADI
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"
)
# → Pogreška Content-type!
# RADI: izravan REST poziv
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"}
}
)
Sažetak kompatibilnosti
| Operacija | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Kompatibilno | Kompatibilno |
| images.edit() | Nekompatibilno | Kompatibilno |
Kontrola troškova
Praćenje potrošnje
Postavi brojač troškova u svoj kod:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # niska kvaliteta; srednja po tarifi mreže
}
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"Potrošeno: ${self.total_spent:.2f}")
print(f"Preostali budžet: ${remaining:.2f}")
# Upotreba
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 troškova
Zlatno pravilo je razdvajanje istraživanja i produkcije. Tijekom traženja odgovarajućeg upita, radi s Imagine 1.0 ($0.02) uz n=3-5 kako bi usporedio varijacije po nižoj cijeni; jednom kada je upit stabilan, prijeđi na Imagine 2.0 s n=1 za konačni render. Ovim slijedom rezerviraš najvišu cijenu samo za odabrane slike.
Dva mehanizma nadopunjuju postavke na strani aplikacije. Prvo, predmemorija (cache) rezultata: ako se isti upit ponovi—vizuali iz kataloga, standardne slike koje regeneriraju više korisnika—posluži već generiranu sliku umjesto plaćanja novog zahtjeva. Zatim kvote, ako tvoji korisnici sami pokreću generiranja: limit po danu ili satu štiti tvoj budžet od nerazumne upotrebe i zlouporabe. Konačno, prati limite brzine (300 RPM standardno, 30 RPM pro): pipeline za batch obradu koji ih ignorira akumulirat će 429 pogreške i nepotrebna ponavljanja.
Procjena mjesečnog budžeta
Za aplikaciju sa 100 korisnika koji generiraju 10 slika dnevno:
- Imagine 1.0: 100 x 10 x 30 x $0.02 = $600/mjesec
- Imagine 2.0 u
low: 100 x 10 x 30 x $0.04 = $1.200/mjesec - Mješovito (80/20): 24.000 x $0.02 + 6.000 x $0.04 = $720/mjesec
Krajnja točka za otkrivanje modela
Za programsku provjeru dostupnih modela slika i njihovih cijena:
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"maks. upit : {model['max_prompt_length']} znakova")
Cjenik od 5. kolovoza 2026. — cijene se redovito mijenjaju: prije bilo kakvog izračuna budžeta, provjeri trenutnu tarifu na službenoj stranici xAI modela i cijena.
Ključne točke
- Moderacija je automatska: rukuj odbijanjima u svom kodu
- OpenAI SDK
images.edit()nije kompatibilan s xAI: koristirequests - OpenAI SDK
images.generate()radi normalno - Implementiraj pratitelja budžeta za kontrolu troškova
- Provjeri modele i cijene putem krajnje točke
/v1/image-generation-models
Provjeri svoje znanje
Generiranje i uređivanje slika: operativni pregled.
1. Što razlikuje Imagine 1.0 i Imagine 2.0?
Odgovor: Kompromis između kvalitete i cijene: Imagine 1.0 ($0.02) za volumen i iteracije, Imagine 2.0 ($0.04 u low, s postavkom quality) za konačne rendere—prototipiraš s prvim, finaliziraš s drugim.
2. Što čini dobar upit (prompt) za sliku?
Odgovor: Subjekt, stil, kompozicija i eksplicitni detalji—opiši scenu kao brief za umjetničko usmjeravanje, zatim iteriraj ciljanim prilagodbama umjesto potpunog prepisivanja.
3. Što omogućuje krajnja točka /v1/images/edits?
Odgovor: Uređivanje postojećih slika: uređivanje ciljano upitom, uređivanje više slika s referencama i uređivanje u više koraka—precizno retuširaš umjesto ponovnog generiranja.
4. Kako učinkovito proizvoditi u velikom obujmu?
Odgovor: Parametar n za batcheve, asinkroni klijent za propusnost—i budući da su URL-ovi izlaza privremeni, odmah preuzmi i arhiviraj slike.
5. Koje su sigurnosne mjere prije produkcije?
Odgovor: Moderacija upita i izlaza, poznavanje nekompatibilnosti SDK-a i kontrola troškova (model, rezolucija, volumeni)—kreiranje u velikom obujmu zahtijeva upravljanje.
Prototipiraj, uredi, industrijaliziraj, upravljaj: kompletan pipeline za slike—s troškovima pod kontrolom u svakom koraku.