Moderatie, incompatibiliteiten met de SDK en kostenbeheersing
Op deze pagina
Bijgewerkt op 2 november 2026 — Imagine.
grok-imagine-image-qualityis verwijderd op 2 november 2026 (aanvragen worden bediend door Imagine 2.0 inlowkwaliteit): voorbeelden gebruiken nugrok-imagine-image(Imagine 1.0) engrok-imagine-image-2.0(Imagine 2.0,low,mediumofautokwaliteit). Met de OpenAI SDK gaanaspect_ratio,resolutionenqualityviaextra_body, en bewerkingen verlopen via de xAI SDK of een HTTP-verzoek.
De limieten van de image-API begrijpen
Om betrouwbare applicaties te bouwen met de Grok image generation API, moet u de limieten kennen: automatische moderatie, incompatibiliteit met bepaalde OpenAI SDK-methoden en mechanismen voor kostenbeheersing.
Contentmoderatie
De API moduleert automatisch prompts en gegenereerde afbeeldingen. Bepaalde contenttypes worden geweigerd:
- Expliciet gewelddadige content of gore
- Expliciet seksuele content
- Haatdragende of discriminerende content
- Content waarbij minderjarigen op ongepaste wijze betrokken zijn
Wanneer moderatie wordt geactiveerd, retourneert de API een foutmelding in plaats van een afbeelding.
Moderatie-weigeringen afhandelen
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def generate_safe(prompt, **kwargs):
"""Genereer een afbeelding met afhandeling van moderatie-weigeringen."""
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 geweigerd door moderatie: {prompt[:50]}...")
return None
raise
Best practices voor moderatie
In de praktijk behandelt u moderatie liever proactief dan reactief. Als een legitieme prompt wordt geblokkeerd, test dan variaties om het triggerwoord te identificeren—“epic battle” zal slagen waar een grovere term dat niet doet, en het in kaart brengen van deze gevoeligheden voorkomt terugkerende blokkades. Wanneer prompts van uw gebruikers komen, voegt u een server-side prefilter toe vóór de API-aanroep: dit onderschept duidelijk niet-conforme verzoeken zonder een request te verbruiken, en houdt u de controle over het getoonde bericht. Want dit laatste punt maakt het verschil in de ervaring: een moderatie-blokkade mag de gebruiker nooit bereiken als een rauwe technische fout, maar als een helder bericht—“dit verzoek voldoet niet aan onze gebruiksvoorwaarden”—dat uitlegt zonder API-details bloot te geven.
Incompatibiliteit van de OpenAI SDK voor bewerkingen
Dit is een kritiek punt: de OpenAI SDK-methode images.edit() werkt niet met de xAI API. De OpenAI SDK verzendt gegevens als multipart/form-data, terwijl de xAI API application/json verwacht.
# WERKT NIET
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 fout!
# WERKT: directe REST-aanroep
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"}
}
)
Overzicht van compatibiliteit
| Bewerking | OpenAI SDK | REST (requests) |
|---|---|---|
| images.generate() | Compatibel | Compatibel |
| images.edit() | Incompatibel | Compatibel |
Kostenbeheersing
Verbruik monitoren
Stel een uitgaventeller in uw code in:
class ImageBudgetTracker:
PRICES = {
"grok-imagine-image": 0.02,
"grok-imagine-image-2.0": 0.04, # low quality; medium tegen grid-tarief
}
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"Images generated: {self.image_count}")
print(f"Spent: ${self.total_spent:.2f}")
print(f"Remaining budget: ${remaining:.2f}")
# Gebruik
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()
Kosten optimaliseren
De gouden regel is om exploratie en productie te scheiden. Tijdens het zoeken naar de juiste prompt werkt u met Imagine 1.0 ($0,02) met n=3-5 om variaties tegen lagere kosten te vergelijken; zodra de prompt stabiel is, schakelt u over op Imagine 2.0 met n=1 voor de uiteindelijke render. Deze volgorde reserveert het hoogste tarief alleen voor geselecteerde afbeeldingen.
Twee mechanismen completeren de opzet aan de applicatiekant. Ten eerste een result-cache: als dezelfde prompt terugkomt—catalogusvisuals, standaardafbeeldingen die door meerdere gebruikers worden gegenereerd—serveer dan de reeds gegenereerde afbeelding in plaats van te betalen voor een nieuw verzoek. Daarna quotas, als uw gebruikers zelf generaties activeren: een limiet per dag of uur beschermt uw budget tegen onredelijk gebruik en misbruik. Houd tot slot de rate limits in de gaten (300 RPM standaard, 30 RPM pro): een batch-pipeline die deze negeert, stapelt 429-fouten en onnodige retries op.
Schatting van het maandbudget
Voor een app met 100 gebruikers die 10 afbeeldingen per dag genereren:
- Imagine 1.0: 100 x 10 x 30 x $0,02 = $600/maand
- Imagine 2.0 in
low: 100 x 10 x 30 x $0,04 = $1.200/maand - Gemengd (80/20): 24.000 x $0,02 + 6.000 x $0,04 = $720/maand
Endpoint voor modeldiscoverie
Om programmatisch beschikbare imagemodellen en hun prijzen te controleren:
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']}/image, "
f"max prompt : {model['max_prompt_length']} chars")
Tarieven per 5 augustus 2026 — prijzen wijzigen regelmatig: controleer voor elke budgetberekening het huidige tarievenoverzicht op de officiële xAI-pagina voor modellen en tarieven.
Belangrijkste punten
- Moderatie is automatisch: handel weigeringen af in uw code
- OpenAI SDK
images.edit()is incompatibel met xAI: gebruikrequests - OpenAI SDK
images.generate()werkt normaal - Implementeer een budgettracker om uitgaven te beheersen
- Controleer modellen en prijzen via het
/v1/image-generation-modelsendpoint
Test uw kennis
Image generation en editing: het operationele overzicht.
1. Wat onderscheidt Imagine 1.0 en Imagine 2.0?
Antwoord: De afweging tussen kwaliteit en kosten: Imagine 1.0 ($0,02) voor volume en iteraties, Imagine 2.0 ($0,04 in low, met een quality-instelling) voor definitieve renders—u prototypeert met de eerste, finaliseert met de tweede.
2. Wat maakt een goede image-prompt?
Antwoord: Onderwerp, stijl, compositie en expliciete details—beschrijf de scène als een art direction-brief, en iteratie vervolgens met gerichte aanpassingen in plaats van herschrijven.
3. Wat maakt het /v1/images/edits endpoint mogelijk?
Antwoord: Bestaande afbeeldingen bewerken: prompt-gestuurd bewerken, bewerken van meerdere afbeeldingen met referenties, en bewerken in meerdere stappen—u retoucheert precies in plaats van opnieuw te genereren.
4. Hoe produceert u efficiënt in volume?
Antwoord: De parameter n voor batches, de async client voor doorvoer—en omdat output-URLs tijdelijk zijn, download en archiveer u ze onmiddellijk.
5. Welke veiligheidsmaatregelen vóór productie?
Antwoord: Moderatie van prompts en outputs, kennis van SDK-incompatibiliteiten en kostenbeheersing (model, resolutie, volumes)—creëren op schaal vereist governance.
Prototypen, bewerken, industrialiseren, governen: de complete image-pipeline—met kosten onder controle bij elke stap.