Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Moderacija, nezdružljivosti SDK-jev in nadzor stroškov

Lekcija 14 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Razumevanje omejitev API-ja za slike
  2. Moderacija vsebine
  3. Nezdružljivost OpenAI SDK za urejanje
  4. Nadzor stroškov
  5. Končna točka za odkrivanje modelov
  6. Ključne ugotovitve
  7. Preveri svoje znanje

Posodobljeno 2. novembra 2026 — Imagine. grok-imagine-image-quality je bil 2. novembra 2026 odstranjen (njegove zahteve zdaj obravnava Imagine 2.0 v kakovosti low): primeri zdaj uporabljajo grok-imagine-image (Imagine 1.0) in grok-imagine-image-2.0 (Imagine 2.0, kakovost low, medium ali auto). Pri uporabi OpenAI SDK parametri aspect_ratio, resolution in quality potujejo preko extra_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: uporabi requests
  • 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.