Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Moderācija, SDK nesaderība un izmaksu kontrole

Nodarbība 14 no 14 Atjaunota 2026. gada 3. novembris Iesācējs
Šajā lapā
  1. Izprast attēlu API ierobežojumus
  2. Satura moderācija
  3. OpenAI SDK nesaderība rediģēšanai
  4. Izmaksu kontrole
  5. Modeļu atklāšanas galapunkts
  6. Galvenās atziņas
  7. Pārbaudi savas zināšanas

Atjaunināts 2026. gada 2. novembrī — Imagine. grok-imagine-image-quality tika noņemts 2026. gada 2. novembrī (tā pieprasījumus apkalpo Imagine 2.0 ar low kvalitāti): piemēri tagad izmanto grok-imagine-image (Imagine 1.0) un grok-imagine-image-2.0 (Imagine 2.0 ar low, medium vai auto kvalitāti). Izmantojot OpenAI SDK, parametri aspect_ratio, resolution un quality tiek nodoti caur extra_body, bet rediģēšana notiek, izmantojot xAI SDK vai HTTP pieprasījumu.

Izprast attēlu API ierobežojumus

Lai veidotu uzticamas lietotnes ar Grok attēlu ģenerēšanas API, tev jāzina tā ierobežojumi: automātiskā moderācija, nesaderība ar noteiktām OpenAI SDK metodēm un izmaksu kontroles mehānismi.

Satura moderācija

API automātiski moderē uzvednes un ģenerētos attēlus. Noteikti satura veidi tiek noraidīti:

  • Atklāti vardarbīgs vai asiņains saturs
  • Atklāti seksuāls saturs
  • Naida vai diskriminējošs saturs
  • Saturs, kas nepiedienīgi iesaista nepilngadīgos

Kad tiek aktivizēta moderācija, API atgriež kļūdu attēla vietā.

Apstrādāt moderācijas noraidījumus

import requests
import os

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

def generate_safe(prompt, **kwargs):
    """Ģenerē attēlu, apstrādājot moderācijas noraidījumus."""
    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"Moderācija noraidīja uzvedni: {prompt[:50]}...")
            return None
        raise

Moderācijas labākā prakse

Praksē apstrādā moderāciju preventīvi, nevis reaģējot uz kļūdām. Ja likumīga uzvedne tiek bloķēta, testē variācijas, lai identificētu izraisošo vārdu — frāze „epic battle” tiks pieņemta, turpretī rupjāks termins nē, un šo jutīgumu kartēšana novērš atkārtotus bloķējumus. Ja uzvednes nāk no taviem lietotājiem, pirms API izsaukuma pievieno servera puses prefiltu: tas aptver acīmredzami noteikumiem neatbilstošus pieprasījumus, netērējot kvotu, un ļauj tev kontrolēt lietotājam rādāmo ziņojumu. Šis pēdējais punkts ir izšķirošs lietotāja pieredzei: moderācijas bloķējumam nekad nevajadzētu sasniegt lietotāju kā neapstrādātu tehnisku kļūdu, bet gan kā skaidru ziņojumu — „šis pieprasījums neatbilst mūsu lietošanas noteikumiem” — kas paskaidro situāciju, neatklājot API detaļas.

OpenAI SDK nesaderība rediģēšanai

Šis ir kritisks punkts: OpenAI SDK metode images.edit() nedarbojas ar xAI API. OpenAI SDK nosūta datus formātā multipart/form-data, savukārt xAI API sagaida application/json.

# NEDARBOJAS
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"
)
# → Satura tipa kļūda!

# DARBOJAS: tiešs REST izsaukums
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"}
    }
)

Nesaderības kopsavilkums

Operācija OpenAI SDK REST (requests)
images.generate() Saderīgs Saderīgs
images.edit() Nesaderīgs Saderīgs

Izmaksu kontrole

Patēriņa uzraudzība

Izveido izdevumu skaitītāju savā kodā:

class ImageBudgetTracker:
    PRICES = {
        "grok-imagine-image": 0.02,
        "grok-imagine-image-2.0": 0.04,  # zema kvalitāte; vidēja pēc režģa likmes
    }

    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"Ģenerēti attēli: {self.image_count}")
        print(f"Iztērēts: ${self.total_spent:.2f}")
        print(f"Atlikušais budžets: ${remaining:.2f}")

# Lietošana
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()

Izmaksu optimizēšana

Zelta likums ir atdalīt izpēti no ražošanas. Uzvedņu meklēšanas laikā strādā ar Imagine 1.0 (0,02 USD), izmantojot n=3-5, lai salīdzinātu variācijas par zemākām izmaksām; kad uzvedne ir stabila, pārej uz Imagine 2.0 ar n=1 gala renderēšanai. Šī secība rezervē augstāko tarifu tikai atlasītiem attēliem.

Divi mehānismi papildina iestatījumu lietotnes pusē. Pirmkārt, rezultātu kešatmiņa: ja tiek atkārtota tāda pati uzvedne (kataloga vizuālie materiāli, standarta attēli, ko ģenerē vairāki lietotāji), pasniedz jau ģenerēto attēlu, nevis maksā par jaunu pieprasījumu. Otrkārt, kvotas, ja tavu lietotņu ģenerēšanu uzsāk paši lietotāji: limits dienā vai stundā aizsargā tavu budžetu no nepamatotas lietošanas un ļaunprātības. Visbeidzot, seko līdzi ātruma ierobežojumiem (standarta 300 RPM, pro 30 RPM): cauruļvads, kas tos ignorē, uzkrāj 429 kļūdas un liekus mēģinājumus.

Mēneša budžeta aplēse

Lietotnei ar 100 lietotājiem, kas ģenerē 10 attēlus dienā:

  • Imagine 1.0: 100 x 10 x 30 x 0,02 USD = 600 USD/mēnesī
  • Imagine 2.0 ar low: 100 x 10 x 30 x 0,04 USD = 1200 USD/mēnesī
  • Jaukts (80/20): 24 000 x 0,02 USD + 6 000 x 0,04 USD = 720 USD/mēnesī

Modeļu atklāšanas galapunkts

Lai programmiski pārbaudītu pieejamos attēlu modeļus un to cenas:

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']}/attēls, "
          f"maks. uzvedne : {model['max_prompt_length']} zīmes")

Tarifi uz 2026. gada 5. augustu — cenas mainās regulāri: pirms jebkādiem budžeta aprēķiniem pārbaudi aktuālo režģi oficiālajā xAI modeļu un tarifu lapā.

Galvenās atziņas

  • Moderācija ir automātiska: apstrādā noraidījumus savā kodā
  • OpenAI SDK images.edit() ir nesaderīgs ar xAI: izmanto requests
  • OpenAI SDK images.generate() darbojas normāli
  • Ievies budžeta izsekotāju, lai kontrolētu izdevumus
  • Pārbaudi modeļus un cenas, izmantojot galapunktu /v1/image-generation-models

Pārbaudi savas zināšanas

Attēlu ģenerēšana un rediģēšana: operacionālais pārskats.

1. Kas atšķir Imagine 1.0 un Imagine 2.0?

Atbilde: Kvalitātes un izmaksu kompromiss: Imagine 1.0 (0,02 USD) apjomam un iterācijām, Imagine 2.0 (0,04 USD ar low, ar quality iestatījumu) gala renderēšanai — tu veido prototipu ar pirmo, pabeidz ar otro.

2. Kas veido labu attēla uzvedni?

Atbilde: Temats, stils, kompozīcija un precīzas detaļas — apraksti ainu kā mākslinieciskās vadības briefu, pēc tam iterē ar mērķtiecīgiem pielāgojumiem, nevis pārrakstot visu.

3. Ko ļauj darīt galapunkts /v1/images/edits?

Atbilde: Rediģēt esošos attēlus: uzvednei mērķēta rediģēšana, vairāku attēlu rediģēšana ar atsauces attēliem un daudzkārtēja rediģēšana — tu precīzi retušē, nevis ģenerē no jauna.

4. Kā efektīvi ražot lielos apjomos?

Atbilde: Parametrs n partijām, asinhronais klients caurlaidspējai — un tā kā izvades URL ir pagaidu, nekavējoties lejupielādē un arhivē attēlus.

5. Kādi drošības pasākumi nepieciešami pirms ražošanas?

Atbilde: Uzvedņu un izvades moderācija, zināšanas par SDK nesaderībām un izmaksu kontrole (modelis, izšķirtspēja, apjomi) — radīšana lielos apjomos prasa pārvaldību.

Veido prototipus, rediģē, industrializē, pārvaldi: pilnīgs attēlu cauruļvads — ar izmaksu kontroli katrā posmā.