Moderacija, SDK nesuderinamumas ir išlaidų kontrolė
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. — Imagine.
grok-imagine-image-qualitybuvo pašalintas 2026 m. lapkričio 2 d. (jo užklausas apdoroja Imagine 2.0 naudodamaslowkokybę): pavyzdžiuose dabar naudojamigrok-imagine-image(Imagine 1.0) irgrok-imagine-image-2.0(Imagine 2.0,low,mediumarbaautokokybė). Naudojant OpenAI SDK, parametraiaspect_ratio,resolutionirqualityperduodami perextra_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: naudokiterequests - OpenAI SDK
images.generate()veikia normaliai - Įdiekite biudžeto stebėklį išlaidoms kontroliuoti
- Tikrinkite modelius ir kainas per
/v1/image-generation-modelsgalinį 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.