Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Moderacija, SDK nesuderinamumas ir išlaidų kontrolė

Paskaita 14 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Pradedantisiems
Šiame puslapyje
  1. Supraskite vaizdų API ribas
  2. Turinio moderacija
  3. OpenAI SDK nesuderinamumas redaguojant
  4. Išlaidų kontrolė
  5. Modelių atradimo galinis punktas (Endpoint)
  6. Svarbiausi punktai
  7. Patikrinkite savo žinias

Atnaujinta 2026 m. lapkričio 2 d. — Imagine. grok-imagine-image-quality buvo pašalintas 2026 m. lapkričio 2 d. (jo užklausas apdoroja Imagine 2.0 naudodamas low kokybę): pavyzdžiuose dabar naudojami grok-imagine-image (Imagine 1.0) ir grok-imagine-image-2.0 (Imagine 2.0, low, medium arba auto kokybė). Naudojant OpenAI SDK, parametrai aspect_ratio, resolution ir quality perduodami per extra_body, o redagavimas atliekamas naudojant xAI SDK arba HTTP užklausą.

Supraskite vaizdų API ribas

Norint kurti patikimas programas su Grok vaizdų generavimo API, reikia žinoti jo ribas: automatinę moderaciją, nesuderinamumą su tam tikrais OpenAI SDK metodais ir išlaidų kontrolės mechanizmus.

Turinio moderacija

API automatiškai moderuoja užklausas (prompts) ir sugeneruotus vaizdus. Tam tikro tipo turinys yra atmetamas:

  • Atvirai smurtinis ar kraujuotas turinys
  • Atvirai seksualinis turinys
  • Neapykantą kurstantis ar diskriminacinis turinys
  • Turinys, netinkamai vaizduojantis nepilnamečius

Įsijungus moderacijai, API vietoj vaizdo grąžina klaidą.

Kaip tvarkyti moderacijos atmetimus

import requests
import os

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

def generate_safe(prompt, **kwargs):
    """Generuokite vaizdą, tvarkydami moderacijos atmetimus."""
    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"Užklausa atmesta dėl moderacijos: {prompt[:50]}...")
            return None
        raise

Moderacijos geriausios praktikos

Praktiškai moderaciją geriau valdyti iš anksto, o ne reaguoti į ją po fakto. Jei teisėta užklausa blokuojama, išbandykite variantus, kad nustatytumėte sukeltą žodį – pavyzdžiui, „epic battle“ praeis, o šiurkštesnis terminas ne, ir susidarius tokių jautrių vietų žemėlapį išvengsite pasikartojančių blokavimų. Kai užklausas teikia jūsų naudotojai, prieš kreipiantis į API pridėkite serverio pusės prefiltą: jis perims akivaizdžiai taisykles pažeidžiančias užklausas nesunaudodamas užklausos kvotos ir leis jums kontroliuoti rodomą žinutę. Nes būtent šis punktas lemia skirtumą vartotojo patirtyje: moderacijos blokas niekada neturėtų pasiekti naudotojo kaip neapdorota techninė klaida, o turi būti aiški žinutė – „šis prašymas neatitinka mūsų naudojimo sąlygų“ – kuri paaiškina situaciją neatskleisdama API detalių.

OpenAI SDK nesuderinamumas redaguojant

Tai kritinis momentas: OpenAI SDK metodas images.edit() neveikia su xAI API. OpenAI SDK siunčia duomenis kaip multipart/form-data, o xAI API tikisi application/json.

# NEVEIKIA
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"
)
# → Content-type klaida!

# VEIKIA: tiesioginis REST kreipimasis
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"}
    }
)

Suderinamumo santrauka

Operacija OpenAI SDK REST (requests)
images.generate() Suderinama Suderinama
images.edit() Nesuderinama Suderinama

Išlaidų kontrolė

Stebėkite sunaudojimą

Savo kode nustatykite išlaidų skaitiklį:

class ImageBudgetTracker:
    PRICES = {
        "grok-imagine-image": 0.02,
        "grok-imagine-image-2.0": 0.04,  # low kokybė; medium pagal tinklo kainą
    }

    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"Sugeneruota vaizdų: {self.image_count}")
        print(f"Išleista: ${self.total_spent:.2f}")
        print(f"Liko biudžete: ${remaining:.2f}")

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

Optimizuokite išlaidas

Auksinė taisyklė – atskirti tyrinėjimą nuo gamybos. Ieškant tinkamos užklausos, dirbkite su Imagine 1.0 ($0.02) naudodami n=3-5, kad palygintumėte variantus mažesne kaina; kai užklausa stabilizuojasi, pereikite prie Imagine 2.0 su n=1 galutiniam atvaizdavimui. Tokia seka leidžia aukščiausią kainą taikyti tik atrinktiems vaizdams.

Programos pusėje sąranką papildo du mechanizmai. Pirmasis – rezultatų talpykla (cache): jei gaunama ta pati užklausa (katalogo vizualai, standartiniai vaizdai, kuriuos regeneruoja keli naudotojai), pateikite jau sugeneruotą vaizdą vietoj to, kad mokėtumėte už naują užklausą. Antrasis – kvotos, jei generavimą inicijuoja patys naudotojai: dienos ar valandos limitas apsaugo jūsų biudžetą nuo neprotingo naudojimo ir piktnaudžiavimo. Galiausiai stebėkite užklausų dažnio ribas (300 RPM standartinis, 30 RPM profesionalus): konvejerio procesas, kuris jų nepaiso, sukaupia 429 klaidas ir nereikalingus bandymus iš naujo.

Mėnesio biudžeto įvertis

Programai, turinčiai 100 naudotojų, generuojančių po 10 vaizdų per dieną:

  • Imagine 1.0: 100 x 10 x 30 x $0.02 = $600/mėn.
  • Imagine 2.0 low: 100 x 10 x 30 x $0.04 = $1 200/mėn.
  • Mišrus (80/20): 24 000 x $0.02 + 6 000 x $0.04 = $720/mėn.

Modelių atradimo galinis punktas (Endpoint)

Norint programiškai patikrinti available vaizdų modelius ir jų kainas:

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']}/vaizdas, "
          f"maks. užklausa : {model['max_prompt_length']} simb.")

Kainos galioja nuo 2026 m. rugpjūčio 5 d. – kainos keičiasi reguliariai: prieš atlikdami bet kokius biudžeto skaičiavimus, patikrinkite dabartinį kainoraštį oficialiame xAI modelių ir kainų puslapyje.

Svarbiausi punktai

  • Moderacija yra automatinė: tvarkykite atmetimus savo kode
  • OpenAI SDK images.edit() nesuderinamas su xAI: naudokite requests
  • OpenAI SDK images.generate() veikia normaliai
  • Įdiekite biudžeto stebėklį išlaidoms kontroliuoti
  • Tikrinkite modelius ir kainas per /v1/image-generation-models galinį punktą

Patikrinkite savo žinias

Vaizdų generavimas ir redagavimas: operacinė apžvalga.

1. Kuo skiriasi Imagine 1.0 ir Imagine 2.0?

Atsakymas: Kokybės ir kainos santykiu: Imagine 1.0 ($0.02) skirtas dideliam kiekiui ir iteracijoms, Imagine 2.0 ($0.04 esant low, su quality nustatymu) – galutiniams atvaizdavimams; prototipuojate su pirmuoju, baigiate su antruoju.

2. Kas sudaro gerą vaizdo užklausą?

Atsakymas: Objektas, stilius, kompozicija ir aiškios detalės – aprašykite sceną kaip meninės krypties briefą, tada iteruokite tiksliniais pakeitimais, o ne perrašydami viską iš naujo.

3. Ką leidžia daryti /v1/images/edits galinis punktas?

Atsakymas: Redaguoti esamus vaizdus: redagavimas pagal užklausą, kelių vaizdų redagavimas su nuorodomis ir daugiapakopis redagavimas – tiksliai pakoreguojate vietoj to, kad generuotumėte iš naujo.

4. Kaip efektyviai gaminti dideliais kiekiais?

Atsakymas: Naudokite parametrą n partijoms, asinchroninį klientą našumui didinti – ir kadangi išvesties URL yra laikini, nedelsiant atsisiųskite ir archyvuokite vaizdus.

5. Kokios apsaugos priemonės būtinos prieš paleidžiant į gamybą?

Atsakymas: Užklausų ir išvesties moderacija, žinios apie SDK nesuderinamumus ir išlaidų kontrolė (modelis, raiška, apimtys) – kūryba dideliu mastu reikalauja valdysenos.

Prototipuokite, redaguokite, industrializuokite, valdykite: tai pilna vaizdų gamybos grandinė – su kontroliuojamomis išlaidomis kiekviename žingsnyje.