Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Moderatsioon, SDK ühildumatuse probleemid ja kulude kontroll

Õppetund 14 / 14 Värskendatud 3. november 2026 Algajatele
Sellel lehel
  1. Mõista pildi API piiranguid
  2. Sisu moderatsioon
  3. OpenAI SDK ühildumatus muutmisel
  4. Kulude kontroll
  5. Mudelite avastamise lõpp-punkt
  6. Peamised punktid
  7. Testi oma teadmisi

Uuendatud 2. novembril 2026 — Imagine. grok-imagine-image-quality eemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 madalas kvaliteedis low): näited kasutavad nüüd mudeleid grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, kvaliteediga low, medium või auto). OpenAI SDK puhul edastatakse parameetrid aspect_ratio, resolution ja quality väljal extra_body, samas kui piltide muutmine toimub xAI SDK või otsese HTTP-päringu kaudu.

Mõista pildi API piiranguid

Usaldusväärsete rakenduste loomiseks Groki pildigeneratsiooni API-ga pead tundma selle piiranguid: automaatne moderatsioon, kokkusobimatus teatud OpenAI SDK meetoditega ja kulude kontrolli mehhanismid.

Sisu moderatsioon

API modereerib automaatselt nii sisendeid (prompte) kui ka genereeritud pilte. Teatud sisutüübid lükatakse tagasi:

  • Ilmselgelt vägivaldne või verine sisu
  • Ilmselgelt seksuaalne sisu
  • Viha õhutav või diskrimineeriv sisu
  • Alaealisi ebasobivalt kaasav sisu

Kui moderatsioon käivitub, tagastab API veateate pildi asemel.

Moderatsiooni tagasilükkamise käsitlemine

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

def generate_safe(prompt, **kwargs):
    """Genereeri pilt, käsitledes moderatsiooni tagasilükkamisi."""
    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"Moderatsioon lükkas prompti tagasi: {prompt[:50]}...")
            return None
        raise

Moderatsiooni parimad tavad

Praktikas tuleks moderatsiooniga tegeleda ennetavalt, mitte reageerivalt. Kui legitiimne prompt blokeeritakse, testi variatsioone, et tuvastada käivitavat sõna – näiteks „epic battle“ läbib filtri, kus toores väljend mitte, ja nende tundlikkuste kaardistamine hoiab ära korduvad blokeeringud. Kui promptid tulevad sinu kasutajatelt, lisa serveripoolne eelfilter enne API väljakutset: see peatab ilmselgelt reeglitele mittevastavad päringud, tarbimata API päringut, ja hoiab sind kontrolli all kuvatava sõnumi üle. See viimane punkt teebki kogemuses vahet: moderatsiooni blokeering ei tohi kunagi jõuda kasutajani toore tehnilise veana, vaid selge sõnumina – „see päring ei vasta meie kasutustingimustele“ – mis selgitab olukorda ilma API detaile paljastamata.

OpenAI SDK ühildumatus muutmisel

See on kriitiline punkt: OpenAI SDK meetod images.edit() ei tööta xAI API-ga. OpenAI SDK saadab andmed vormingus multipart/form-data, samas kui xAI API ootab vormingut application/json.

# EI TÖÖTA
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"
)
# → Sisutüübi viga!

# TÖÖTAB: otsene REST väljakutse
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"}
    }
)

Ühilduvuse kokkuvõte

Operatsioon OpenAI SDK REST (requests)
images.generate() Ühilduv Ühilduv
images.edit() Mitteühilduv Ühilduv

Kulude kontroll

Tarbimise jälgimine

Seadista oma koodi kulude loendur:

class ImageBudgetTracker:
    PRICES = {
        "grok-imagine-image": 0.02,
        "grok-imagine-image-2.0": 0.04,  # madal kvaliteet; keskmine vastavalt hinnakirjale
    }

    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"Genereeritud pilte: {self.image_count}")
        print(f"Kulutatud: ${self.total_spent:.2f}")
        print(f"Järelejäänud eelarve: ${remaining:.2f}")

# Kasutamine
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()

Kulude optimeerimine

Kuldreegel on eristada uurimist ja tootmist. Prompti otsimise ajal tööta Imagine 1.0-ga ($0.02), kasutades parameetrit n=3-5, et võrrelda variatsioone madalama hinnaga; kui prompt on stabiliseerunud, lülitu lõpliku renderdamise jaoks Imagine 2.0-le parameetriga n=1. See järjestus reserveerib kõrgeima hinna vaid valitud piltidele.

Rakenduse tasandil täiendavad seadistust kaks mehhanismi. Esiteks tulemuste vahemälu: kui sama prompt kordub – kataloogi visuaalid, standardsed pildid, mida mitu kasutajat uuesti genereerivad – serveeri juba loodud pilti uue päringu eest maksmise asemel. Teiseks kvoodid, kui sinu kasutajad käivitavad genereerimisi ise: piirang päevas või tunnis kaitseb sinu eelarvet ebamõistliku kasutuse ja kuritarvituste eest. Lõpuks jälgi kiiruse piiranguid (300 RPM standard, 30 RPM pro): batch-töötlus, mis neid ignoreerib, kuhjab kokku 429 vigu ja tarbetuid uuestiproovimisi.

Kuu eelarve hinnang

Rakendusele, kus 100 kasutajat genereerivad päevas 10 pilti:

  • Imagine 1.0: 100 x 10 x 30 x $0.02 = $600/kuus
  • Imagine 2.0 kvaliteediga low: 100 x 10 x 30 x $0.04 = $1200/kuus
  • Segatud (80/20): 24 000 x $0.02 + 6000 x $0.04 = $720/kuus

Mudelite avastamise lõpp-punkt

Saadaval olevate pildimudelite ja nende hindade programmiliseks kontrollimiseks:

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']}/pilt, "
          f"max prompt : {model['max_prompt_length']} tähemärki")

Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve arvutamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.

Peamised punktid

  • Moderatsioon on automaatne: käsitle tagasilükkamisi oma koodis
  • OpenAI SDK images.edit() ei ühildu xAI-ga: kasuta requests
  • OpenAI SDK images.generate() töötab normaalselt
  • Rakenda eelarve jälgija kulude kontrollimiseks
  • Kontrolli mudeleid ja hindu lõpp-punkti /v1/image-generation-models kaudu

Testi oma teadmisi

Piltide genereerimine ja muutmine: operatiivne ülevaade.

1. Mis eristab Imagine 1.0 ja Imagine 2.0?

Vastus: Kvaliteedi ja hinna kompromiss: Imagine 1.0 ($0.02) mahukate iteratsioonide jaoks, Imagine 2.0 ($0.04 kvaliteediga low, seadistusega quality) lõplike renderduste jaoks – prototüübi esimesega, viimistled teisega.

2. Mis teeb hea pildi prompti?

Vastus: Subjekt, stiil, kompositsioon ja konkreetsed detailid – kirjelda stseeni nagu kunstilise suunise briefi, seejärel tee sihipäraseid kohendusi, mitte ümberkirjutamist.

3. Mida võimaldab lõpp-punkt /v1/images/edits?

Vastus: Olemasolevate piltide muutmine: promptipõhine muutmine, mitme pildi muutmine viidetega ja mitme vooruga muutmine – täpne retušeerimine uuesti genereerimise asemel.

4. Kuidas toota suurtes kogustes tõhusalt?

Vastus: Parameeter n partii jaoks, asünkroonne klient läbilaskevõime suurendamiseks – ja kuna väljundi URL-id on ajutised, laadi ja arhiveeri need kohe.

5. Millised kaitsemeetmed enne tootmist?

Vastus: Promptide ja väljundite moderatsioon, teadlikkus SDK ühildumatustest ja kulude kontroll (mudel, resolutsioon, mahud) – loomine suures mastaabis nõuab juhtimist.

Prototüübi loomine, muutmine, industrialiseerimine, juhtimine: täielik pilditöötluse torustik – kulud kontrolli all igas etapis.