Salt la conținutul principal
Română— Alege o limbă
Meniu

Moderare, incompatibilități SDK și controlul costurilor

Lecția 14 din 14 Actualizată 3 noiembrie 2026 Începător
Pe această pagină
  1. Înțelegeți limitele API-ului de imagini
  2. Moderarea conținutului
  3. Incompatibilitatea SDK-ului OpenAI pentru editare
  4. Controlul costurilor
  5. Punctul final de descoperire a modelelor
  6. Puncte cheie
  7. Testați-vă cunoștințele

Actualizat pe 2 noiembrie 2026 — Imagine. grok-imagine-image-quality a fost eliminat pe 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 în calitate low): exemplele folosesc acum grok-imagine-image (Imagine 1.0) și grok-imagine-image-2.0 (Imagine 2.0, calitate low, medium sau auto). Cu SDK-ul OpenAI, aspect_ratio, resolution și quality se transmit prin extra_body, iar editarea se face prin SDK-ul xAI sau o cerere HTTP.

Înțelegeți limitele API-ului de imagini

Pentru a construi aplicații fiabile cu API-ul de generare de imagini Grok, trebuie să îi cunoașteți limitele: moderarea automată, incompatibilitatea cu anumite metode ale SDK-ului OpenAI și mecanismele de control al costurilor.

Moderarea conținutului

API-ul modulează automat prompturile și imaginile generate. Anumite tipuri de conținut sunt refuzate:

  • Conținut explicit violent sau sângeros
  • Conținut explicit sexual
  • Conținut instigator la ură sau discriminatoriu
  • Conținut care implică minori în mod inadecvat

Când moderarea este declanșată, API-ul returnează o eroare în loc de o imagine.

Gestionați refuzurile de moderare

import requests
import os

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

def generate_safe(prompt, **kwargs):
    """Generează o imagine gestionând refuzurile de moderare."""
    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"Prompt refuzat de moderare: {prompt[:50]}...")
            return None
        raise

Cele mai bune practici de moderare

În practică, gestionați moderarea preventiv, nu reactiv. Dacă un prompt legitim este blocat, testați variațiuni pentru a identifica cuvântul declanșator—„bătălie epică“ va trece acolo unde un termen mai crud nu va, iar cartografierea acestor sensibilități evită blocările recurente. Când prompturile provin de la utilizatorii dumneavoastră, adăugați un prefiltru lato-server înainte de apelul API: acesta interceptează cererile evident în afara politicii fără a consuma o cerere și vă menține controlul asupra mesajului afișat. Deoarece acest ultim punct face diferența de experiență: un blocaj de moderare nu ar trebui să ajungă niciodată la utilizator ca o eroare tehnică brută, ci ca un mesaj clar—„această cerere nu respectă termenii noștri de utilizare“—care explică fără a expune detaliile API-ului.

Incompatibilitatea SDK-ului OpenAI pentru editare

Acesta este un punct critic: metoda images.edit() din SDK-ul OpenAI nu funcționează cu API-ul xAI. SDK-ul OpenAI trimite datele ca multipart/form-data, în timp ce API-ul xAI se așteaptă la application/json.

# NU FUNCȚIONEAZĂ
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"
)
# → Eroare de tip conținut!

# FUNCȚIONEAZĂ: apel REST direct
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"}
    }
)

Rezumat al compatibilității

Operație SDK OpenAI REST (requests)
images.generate() Compatibil Compatibil
images.edit() Incompatibil Compatibil

Controlul costurilor

Monitorizați consumul

Configurați un contor de cheltuieli în codul dumneavoastră:

class ImageBudgetTracker:
    PRICES = {
        "grok-imagine-image": 0.02,
        "grok-imagine-image-2.0": 0.04,  # calitate low; medium la tariful grilei
    }

    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"Imagini generate: {self.image_count}")
        print(f"Cheltuit: ${self.total_spent:.2f}")
        print(f"Buget rămas: ${remaining:.2f}")

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

Optimizați costurile

Regula de aur este separarea explorării de producție. În timpul căutării promptului, lucrați cu Imagine 1.0 (0,02 USD) cu n=3-5 pentru a compara variațiuni la un cost mai mic; odată ce promptul este stabil, treceți la Imagine 2.0 cu n=1 pentru randarea finală. Această secvențiere rezervă tariful cel mai ridicat doar pentru imaginile selectate.

Două mecanisme completează configurarea din partea aplicației. În primul rând, un cache de rezultate: dacă același prompt revine—vizuale de catalog, imagini standard regenerate de mai mulți utilizatori—serviți imaginea deja generată în loc să plătiți pentru o nouă cerere. Apoi cotele, dacă utilizatorii dumneavoastră declanșează generările: o limită pe zi sau pe oră vă protejează bugetul de utilizarea nerezonabilă și de abuzuri. În final, țineți sub observație limitele de rată (300 RPM standard, 30 RPM pro): o pipeline batch care le ignoră acumulează erori 429 și reîncercări inutile.

Estimarea bugetului lunar

Pentru o aplicație cu 100 de utilizatori care generează 10 imagini pe zi:

  • Imagine 1.0: 100 x 10 x 30 x 0,02 USD = 600 USD/lună
  • Imagine 2.0 în low: 100 x 10 x 30 x 0,04 USD = 1.200 USD/lună
  • Mixt (80/20): 24.000 x 0,02 USD + 6.000 x 0,04 USD = 720 USD/lună

Punctul final de descoperire a modelelor

Pentru a verifica programatic modelele de imagini disponibile și prețurile acestora:

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']}/imagine, "
          f"lungime maximă prompt : {model['max_prompt_length']} caractere")

Tarife valabile la 5 august 2026 — prețurile se schimbă regulat: înainte de orice calcul bugetar, verificați grila actuală pe pagina oficială a modelelor și tarifelor xAI.

Puncte cheie

  • Moderarea este automată: gestionați refuzurile în codul dumneavoastră
  • images.edit() din SDK-ul OpenAI este incompatibil cu xAI: folosiți requests
  • images.generate() din SDK-ul OpenAI funcționează normal
  • Implementați un tracker de buget pentru a controla cheltuielile
  • Verificați modelele și prețurile prin endpoint-ul /v1/image-generation-models

Testați-vă cunoștințele

Generarea și editarea imaginilor: prezentarea operațională.

1. Ce diferențiază Imagine 1.0 de Imagine 2.0?

Răspuns: Compromisul calitate/cost: Imagine 1.0 (0,02 USD) pentru volum și iterații, Imagine 2.0 (0,04 USD în low, cu setarea quality) pentru randările finale—prototipați cu primul, finalizați cu al doilea.

2. Ce constituie un prompt de imagine bun?

Răspuns: Subiectul, stilul, compoziția și detaliile explicite—descrieți scena ca pe un brief de direcție artistică, apoi iterați cu ajustări țintite în loc să rescrieți totul.

3. Ce permite endpoint-ul /v1/images/edits?

Răspuns: Editarea imaginilor existente: editare țintită prin prompt, editare multi-imagine cu referințe și editare multi-tur—retușați precis în loc să regenerați.

4. Cum să produceți în volum eficient?

Răspuns: Parametrul n pentru loturi, clientul asincron pentru debit—și deoarece URL-urile de ieșire sunt temporare, descărcați și arhivați imediat.

5. Ce măsuri de siguranță înainte de producție?

Răspuns: Moderarea prompturilor și a ieșirilor, cunoașterea incompatibilităților SDK și controlul costurilor (model, rezoluție, volume)—crearea la scară necesită guvernanță.

Prototipați, editați, industrializați, guvernați: pipeline-ul complet de imagini—cu costuri sub control la fiecare pas.