Moderare, incompatibilități SDK și controlul costurilor
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Imagine.
grok-imagine-image-qualitya fost eliminat pe 2 noiembrie 2026 (cererile sale sunt deservite de Imagine 2.0 în calitatelow): exemplele folosesc acumgrok-imagine-image(Imagine 1.0) șigrok-imagine-image-2.0(Imagine 2.0, calitatelow,mediumsauauto). Cu SDK-ul OpenAI,aspect_ratio,resolutionșiqualityse transmit prinextra_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țirequestsimages.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.