SpaceXAI: Grok Imagine Image Quality
Grok Imagine Image Quality genereert en bewerkt afbeeldingen met de nadruk op realisme, tekstweergave en creatieve controle. Gebruik een nauwkeurige tekstbriefing en eventueel referenties om productbeelden, campagnemateriaal, pictogrammen of een gerichte herziening van een bestaande afbeelding te maken.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Grok Imagine Image Quality is het benoemde model van SpaceXAI voor het genereren en bewerken van afbeeldingen, met de nadruk op realistische details, betere tekstweergave en het nauwkeurig volgen van een creatieve briefing. Het accepteert tekst en optioneel beeldreferenties en levert een afbeelding op. Toepassingen zijn onder meer productvisualisatie, campagnebeelden, materiaal voor sociale media, illustraties en pictogrammen in interfacestijl. Het stijlbereik omvat fotografische en filmische beelden, maar ook grafisch werk.
Beschrijf voor een productscène eerst het object, de opstelling, het materiaal, de belichting en het camerastandpunt, voordat je een decoratieve stijl toevoegt. Lever een referentie aan wanneer de vorm of de belettering van het product herkenbaar moet blijven. Een bruikbare briefing kan een klein flesje met etiket op een stenen oppervlak plaatsen, met een bepaald kleurenpalet en ruimte voor een kop. Geef voor een pictogram of grafisch beeld de vorm, het contrast en de beoogde visuele schaal aan. Het resultaat is een gerenderde afbeelding, geen werkende interface of bewerkbaar opmaakbestand.
Bij bewerken voeg je een bronafbeelding toe aan de instructie. Opgeslagen beeldreferenties in de workflow van de producent moeten volledig zijn geüpload en PNG, JPEG of WebP gebruiken. Benoem de wijziging en wat behouden moet blijven: een nieuwe achtergrond, een ander materiaal, een gerichte stijltransformatie of een gecorrigeerd bijschrift. Als meerdere referenties bijdragen aan een compositie, beschrijf hun rollen dan afzonderlijk, bijvoorbeeld het product uit de ene afbeelding en de merkuitstraling uit een andere. Houd de oorspronkelijke productreferentie beschikbaar, zodat latere herzieningen de identiteit uit het eerste beeld niet verliezen.
Een praktische reeks kan beginnen met een productrender en datzelfde beeld vervolgens in een andere omgeving of een printcompositie plaatsen. Gebruik de gekozen uitvoer als invoer voor de volgende bewerking en richt de nieuwe instructie op de transformatie. Behoud voor een campagnevariant het geslaagde onderwerp en de hiërarchie, terwijl je de omgeving of ondersteunende tekst verandert. Zo ontwikkel je een afbeelding in expliciete stappen, in plaats van te verwachten dat een latere prompt een eerder beeld onthoudt dat niet is meegeleverd.
Typografie en fijne texturen behoren tot de creatieve aandachtspunten van het Quality-model. Geef de exacte woorden, cijfers en plaatsing voor een menu, etiket of advertentie en beschrijf hoe de tekst in het materiaal of de compositie moet passen. Controleer spelling, leesvolgorde en kleine letters op de werkelijke weergavegrootte. Een realistische textuur kan de visuele presentatie van een product ondersteunen; de feitelijke producteigenschappen moeten nog steeds uit de goedgekeurde briefing en referenties komen.
De beeldworkflow van de producent ondersteunt resolutiekeuzes van 1K en 2K en liggende, vierkante of staande composities, met automatische keuze van de beeldverhouding als deze niet is opgegeven. Kies de beeldvorm op basis van het onderwerp en de plaatsing van tekst, in plaats van resolutie als vervanging voor opmaak te gebruiken. Via de algemene instelling voor het aantal gegenereerde afbeeldingen kun je meerdere alternatieven aanvragen: van één tot tien, met één als standaard. Alternatieven vergelijken helpt bij het kiezen van een compositie; het bewijst niet dat elk gevraagd detail in ieder resultaat aanwezig is.
Afbeeldingen worden doorgaans geleverd via tijdelijke gehoste locaties. Levering als base64 is beschikbaar wanneer de afbeelding rechtstreeks in een applicatiebestand moet worden opgenomen. Bewaar het daadwerkelijk gekozen beeld en vertrouw niet op een tijdelijke locatie als enige projectkopie. De integratie voor afbeeldingsbestanden van de producent laat ook zien hoe je opgeslagen afbeeldings-ID's als referenties gebruikt en gegenereerde afbeeldingsbestanden voor later gebruik opslaat. Deze keuzes voor levering en opslag staan los van de visuele briefing die bepaalt wat de afbeelding moet tonen.
Het benoemde Image Quality-model verschilt van de kwaliteitsparameter low, medium en auto van Grok Imagine Image 2.0. Die latere kwaliteitsinstellingen en uitgebreidere keuzes voor referenties of beeldverhoudingen mogen niet als instellingen van dit profiel worden beschouwd. Meerdere alternatieven aanvragen in één beeldaanroep verschilt ook van de Batch API van de fabrikant, die op de pagina van het specifieke Quality-model niet als ondersteund staat vermeld. Houd bij het voorbereiden van een herhaalbare workflow de modelkeuze, prompt, referenties en gekozen uitvoer van de afbeelding bij elkaar.
Vergelijk voor een bruikbare, voltooide afbeelding de gevraagde scène, productdetails, typografie en behouden elementen met de briefing en herzie vervolgens het specifieke onderdeel dat niet aan het doel voldeed. Een gegenereerd stilstaand beeld kan dienen als referentie voor een afzonderlijke videotaak, maar het eigen resultaat van het beeldmodel blijft een afbeelding. Bewaar de geslaagde versie en het referentiemateriaal, zodat een latere campagnebewerking of gewijzigde plaatsing dezelfde creatieve richting kan verfijnen.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-qualityAan de slag
Grok Imagine Image Quality genereert en bewerkt afbeeldingen met de nadruk op realisme, tekstweergave en creatieve controle. Gebruik een nauwkeurige tekstbriefing en eventueel referenties om productbeelden, campagnemateriaal, pictogrammen of een gerichte herziening van een bestaande afbeelding te maken.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten x-ai/grok-imagine-image-quality | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1K, 2K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 3 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieinvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper invoerafbeelding | Kosten Invoer · invoerafbeelding · Schatting uitsluitend ter vergelijking $0.02 per invoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.1 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-quality', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra x-ai/grok-imagine-image-quality
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · SpaceXAI: Grok Imagine Image Quality
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:model,prompt,resolution,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:n.minimum:1;n.maximum:1