Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Moderacija, nekompatibilnosti SDK-a i kontrola troškova

Lekcija 14 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Razumijevanje ograničenja API-ja za slike
  2. Moderacija sadržaja
  3. Nekompatibilnost OpenAI SDK-a za uređivanje
  4. Kontrola troškova
  5. Krajnja točka za otkrivanje modela
  6. Ključne točke
  7. Provjeri svoje znanje

Ažurirano 2. studenoga 2026. — Imagine. grok-imagine-image-quality uklonjen je 2. studenoga 2026. (njegovi se zahtjevi obrađuju putem Imagine 2.0 u low kvaliteti): primjeri sada koriste grok-imagine-image (Imagine 1.0) i grok-imagine-image-2.0 (Imagine 2.0, kvaliteta low, medium ili auto). Kod OpenAI SDK-a, parametri aspect_ratio, resolution i quality prosljeđuju se kroz extra_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: koristi requests
  • 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.