Moderatsioon, SDK ühildumatuse probleemid ja kulude kontroll
Sellel lehel
Uuendatud 2. novembril 2026 — Imagine.
grok-imagine-image-qualityeemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 madalas kvaliteedislow): näited kasutavad nüüd mudeleidgrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, kvaliteedigalow,mediumvõiauto). OpenAI SDK puhul edastatakse parameetridaspect_ratio,resolutionjaqualityväljalextra_body, samas kui piltide muutmine toimub xAI SDK või otsese HTTP-päringu kaudu.
Mõista pildi API piiranguid
Usaldusväärsete rakenduste loomiseks Groki pildigeneratsiooni API-ga pead tundma selle piiranguid: automaatne moderatsioon, kokkusobimatus teatud OpenAI SDK meetoditega ja kulude kontrolli mehhanismid.
Sisu moderatsioon
API modereerib automaatselt nii sisendeid (prompte) kui ka genereeritud pilte. Teatud sisutüübid lükatakse tagasi:
- Ilmselgelt vägivaldne või verine sisu
- Ilmselgelt seksuaalne sisu
- Viha õhutav või diskrimineeriv sisu
- Alaealisi ebasobivalt kaasav sisu
Kui moderatsioon käivitub, tagastab API veateate pildi asemel.
Moderatsiooni tagasilükkamise käsitlemine
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Genereeri pilt, käsitledes moderatsiooni tagasilükkamisi."""
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"Moderatsioon lükkas prompti tagasi: {prompt[:50]}...")
return None
raise
Moderatsiooni parimad tavad
Praktikas tuleks moderatsiooniga tegeleda ennetavalt, mitte reageerivalt. Kui legitiimne prompt blokeeritakse, testi variatsioone, et tuvastada käivitavat sõna – näiteks „epic battle“ läbib filtri, kus toores väljend mitte, ja nende tundlikkuste kaardistamine hoiab ära korduvad blokeeringud. Kui promptid tulevad sinu kasutajatelt, lisa serveripoolne eelfilter enne API väljakutset: see peatab ilmselgelt reeglitele mittevastavad päringud, tarbimata API päringut, ja hoiab sind kontrolli all kuvatava sõnumi üle. See viimane punkt teebki kogemuses vahet: moderatsiooni blokeering ei tohi kunagi jõuda kasutajani toore tehnilise veana, vaid selge sõnumina – „see päring ei vasta meie kasutustingimustele“ – mis selgitab olukorda ilma API detaile paljastamata.
OpenAI SDK ühildumatus muutmisel
See on kriitiline punkt: OpenAI SDK meetod images.edit() ei tööta xAI API-ga. OpenAI SDK saadab andmed vormingus multipart/form-data, samas kui xAI API ootab vormingut application/json.
# EI TÖÖTA
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"
)
# → Sisutüübi viga!
# TÖÖTAB: otsene REST väljakutse
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"}
}
)
Ühilduvuse kokkuvõte
| Operatsioon | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Ühilduv | Ühilduv |
| images.edit() | Mitteühilduv | Ühilduv |
Kulude kontroll
Tarbimise jälgimine
Seadista oma koodi kulude loendur:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # madal kvaliteet; keskmine vastavalt hinnakirjale
}
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"Genereeritud pilte: {self.image_count}")
print(f"Kulutatud: ${self.total_spent:.2f}")
print(f"Järelejäänud eelarve: ${remaining:.2f}")
# Kasutamine
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()
Kulude optimeerimine
Kuldreegel on eristada uurimist ja tootmist. Prompti otsimise ajal tööta Imagine 1.0-ga ($0.02), kasutades parameetrit n=3-5, et võrrelda variatsioone madalama hinnaga; kui prompt on stabiliseerunud, lülitu lõpliku renderdamise jaoks Imagine 2.0-le parameetriga n=1. See järjestus reserveerib kõrgeima hinna vaid valitud piltidele.
Rakenduse tasandil täiendavad seadistust kaks mehhanismi. Esiteks tulemuste vahemälu: kui sama prompt kordub – kataloogi visuaalid, standardsed pildid, mida mitu kasutajat uuesti genereerivad – serveeri juba loodud pilti uue päringu eest maksmise asemel. Teiseks kvoodid, kui sinu kasutajad käivitavad genereerimisi ise: piirang päevas või tunnis kaitseb sinu eelarvet ebamõistliku kasutuse ja kuritarvituste eest. Lõpuks jälgi kiiruse piiranguid (300 RPM standard, 30 RPM pro): batch-töötlus, mis neid ignoreerib, kuhjab kokku 429 vigu ja tarbetuid uuestiproovimisi.
Kuu eelarve hinnang
Rakendusele, kus 100 kasutajat genereerivad päevas 10 pilti:
- Imagine 1.0: 100 x 10 x 30 x $0.02 = $600/kuus
- Imagine 2.0 kvaliteediga
low: 100 x 10 x 30 x $0.04 = $1200/kuus - Segatud (80/20): 24 000 x $0.02 + 6000 x $0.04 = $720/kuus
Mudelite avastamise lõpp-punkt
Saadaval olevate pildimudelite ja nende hindade programmiliseks kontrollimiseks:
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']}/pilt, "
f"max prompt : {model['max_prompt_length']} tähemärki")
Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve arvutamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.
Peamised punktid
- Moderatsioon on automaatne: käsitle tagasilükkamisi oma koodis
- OpenAI SDK
images.edit()ei ühildu xAI-ga: kasutarequests - OpenAI SDK
images.generate()töötab normaalselt - Rakenda eelarve jälgija kulude kontrollimiseks
- Kontrolli mudeleid ja hindu lõpp-punkti
/v1/image-generation-modelskaudu
Testi oma teadmisi
Piltide genereerimine ja muutmine: operatiivne ülevaade.
1. Mis eristab Imagine 1.0 ja Imagine 2.0?
Vastus: Kvaliteedi ja hinna kompromiss: Imagine 1.0 ($0.02) mahukate iteratsioonide jaoks, Imagine 2.0 ($0.04 kvaliteediga low, seadistusega quality) lõplike renderduste jaoks – prototüübi esimesega, viimistled teisega.
2. Mis teeb hea pildi prompti?
Vastus: Subjekt, stiil, kompositsioon ja konkreetsed detailid – kirjelda stseeni nagu kunstilise suunise briefi, seejärel tee sihipäraseid kohendusi, mitte ümberkirjutamist.
3. Mida võimaldab lõpp-punkt /v1/images/edits?
Vastus: Olemasolevate piltide muutmine: promptipõhine muutmine, mitme pildi muutmine viidetega ja mitme vooruga muutmine – täpne retušeerimine uuesti genereerimise asemel.
4. Kuidas toota suurtes kogustes tõhusalt?
Vastus: Parameeter n partii jaoks, asünkroonne klient läbilaskevõime suurendamiseks – ja kuna väljundi URL-id on ajutised, laadi ja arhiveeri need kohe.
5. Millised kaitsemeetmed enne tootmist?
Vastus: Promptide ja väljundite moderatsioon, teadlikkus SDK ühildumatustest ja kulude kontroll (mudel, resolutsioon, mahud) – loomine suures mastaabis nõuab juhtimist.
Prototüübi loomine, muutmine, industrialiseerimine, juhtimine: täielik pilditöötluse torustik – kulud kontrolli all igas etapis.