Moderācija, SDK nesaderība un izmaksu kontrole
Šajā lapā
Atjaunināts 2026. gada 2. novembrī — Imagine.
grok-imagine-image-qualitytika noņemts 2026. gada 2. novembrī (tā pieprasījumus apkalpo Imagine 2.0 arlowkvalitāti): piemēri tagad izmantogrok-imagine-image(Imagine 1.0) ungrok-imagine-image-2.0(Imagine 2.0 arlow,mediumvaiautokvalitāti). Izmantojot OpenAI SDK, parametriaspect_ratio,resolutionunqualitytiek nodoti caurextra_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: izmantorequests - 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ā.