xAI: Grok Imagine Image 2.0
Grok Imagine Image 2.0 maakt beelden op basis van geschreven briefings en bewerkt bestaande beelden via instructies in natuurlijke taal. xAI documenteert instelbare kwaliteit, resolutie en compositie, referenties met meerdere beelden, stijloverdracht en iteratieve verfijning.
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 2.0 is het model van xAI voor beeldgeneratie en -bewerking. Het krijgt een geschreven beschrijving, of een beschrijving samen met bronbeelden, en levert een beeldresultaat. Het benoemde 2.0-profiel van de producent omvat het maken van een scène, het wijzigen van een bestaand beeld, het combineren van onderwerpen uit referenties en het transformeren van de visuele stijl. Bepaal eerst of je een nieuwe compositie of een specifieke wijziging van bestaand materiaal nodig hebt.
Een beeld maken op basis van een briefing
Beschrijf het hoofdonderwerp, de omgeving, compositie, belichting en visuele uitwerking. Geef aan wat de kijker eerst moet opmerken en waar het beeld zal worden gebruikt. Voor een productconcept kan een voorbeeldbriefing een keramische bureaulamp op een bleke stenen tafel beschrijven, met zacht raamlicht, een detailweergave van het materiaal en vrije ruimte voor een afzonderlijke titel. Geef voor een illustratie de personages, handeling en beoogde esthetiek op, in plaats van te verwachten dat één stijlwoord de hele scène bepaalt.
De producent documenteert één tot tien uitvoerbeelden per generatieverzoek, met één als standaard. Meerdere resultaten uit dezelfde briefing leveren alternatieven om te beoordelen; ze garanderen geen identiek onderwerp in elke variant. Controleer het onderwerp, de compositie en belangrijke details en bewaar daarna de versie die het best bij de briefing past. Houd de briefing en de gekozen variant bij elkaar, zodat latere bewerkingen de bedoelde compositie gebruiken.
Compositie, resolutie en kwaliteit
De generatiehandleiding documenteert automatische keuze van de beeldverhouding of een expliciete verhouding. De vermelde keuzes omvatten 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 en 5:2. Kies de vorm op basis van de beoogde plaatsing: vierkant voor een compacte tegel, staand voor een verticale compositie of liggend voor een brede scène. Geef het onderwerp dat gevoelig is voor uitsnijden en de ruimte die de lay-out nodig heeft op, in plaats van alleen op de beeldverhouding te vertrouwen.
De gedocumenteerde instellingen voor generatieresolutie zijn 1k en 2k, met 1k als standaard. Kwaliteit is een afzonderlijke regeling met de keuzes low, medium en auto. In de huidige handleiding van xAI is auto de standaard en gebruikt die low voor generatie en medium voor bewerking; een expliciete instelling low of medium legt die keuze vast. Resolutie en kwaliteit beschrijven dus verschillende regelingen. Vermeld de visuele details die van belang zijn en controleer ze in het teruggestuurde beeld, in plaats van een van beide instellingen als garantie voor exacte belettering, geometrie of behoud van het onderwerp te beschouwen.
Beelden bewerken en visuele stijl overdragen
Lever het te veranderen beeld aan en beschrijf de gevraagde wijziging in relatie tot de zichtbare inhoud. Een gerichte bewerking kan vragen een donkere muur door een licht gepleisterd oppervlak te vervangen, met behoud van de meubelopstelling, het camerastandpunt en de warme belichting. Geef bij een stijltransformatie de gewenste uitwerking op: de producent demonstreert fotografie, anime, olieverf, aquarel, popart en potloodschetsen. Benoem welke elementen hun uiterlijk moeten behouden en welke met de uitwerking mogen veranderen.
De bewerkingsworkflow van de fabrikant aanvaardt een bronbeeldreferentie, gecodeerde beeldgegevens of een bestands-ID. Gebruik voor opgeslagen referenties volledig geüploade PNG-, JPEG- of WebP-beelden. De handleiding documenteert ook opeenvolgende bewerkingen: gebruik het resultaat van de ene bewerking als invoer voor de volgende. Zo kan een basiscompositie via een meubelwijziging en daarna een lichtaanpassing een specifieker resultaat worden. Houd het origineel en het gekozen tussentijdse beeld verbonden met elke briefing, zodat een latere verfijning aan de bedoelde compositie kan worden getoetst.
Meerdere referenties combineren
De huidige handleiding voor meerdere beelden laat maximaal vijf bronbeelden toe in één bewerking. Verwijs ernaar in de aangeleverde volgorde en geef elk een duidelijke rol, zoals het onderwerp uit het eerste beeld en de omgeving uit het tweede. De uitvoerverhouding volgt standaard het eerste invoerbeeld; een expliciete verhouding kan die vervangen. Beschrijf voor een product-in-een-ruimteconcept de positie, grootte en het contact van het product met de oppervlakken in de ruimte en vraag daarna de herkenbare details te behouden. Beoordeel hoe de bronnen zijn gecombineerd, in plaats van aan te nemen dat elk element ongewijzigd is gekopieerd.
Het beeld ontvangen en bewaren
De producent levert standaard een tijdelijk beeldadres en documenteert ook uitvoer als gecodeerd beeld. Bewaar het werkelijke beeld snel wanneer het als bestand nodig is. De optionele uitgestelde workflow scheidt de ontvangstbevestiging van het verzoek van de voltooiing: na een verzoek-ID volgt de status pending, done of failed. Uitgestelde resultaten gebruiken het adresresponsformaat met een gedocumenteerde bewaartermijn van 24 uur. Een ingediend verzoek of een status pending is geen afgewerkt beeld. Bewaar het voltooide beeld met de briefing en gekozen instellingen voor later hergebruik.
Een bruikbaar eindresultaat is een beeld dat bij een welbepaalde scène, lay-out of bewerkingsbriefing past. Controleer de volledige compositie en kleine details, vooral het brononderwerp, objectgrenzen, verhoudingen en betekenisdragende belettering. Verander bij iteratief werk de instructie die bij het zichtbare probleem hoort en gebruik het gekozen resultaat als volgende referentie. Houd de gewenste wijziging en instructies voor behoud concreet, zodat elk resultaat aan een specifiek creatief doel kan worden getoetst.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations x-ai/grok-imagine-image-2.0
x-ai/grok-imagine-image-2.0Aan de slag
Grok Imagine Image 2.0 maakt beelden op basis van geschreven briefings en bewerkt bestaande beelden via instructies in natuurlijke taal. xAI documenteert instelbare kwaliteit, resolutie en compositie, referenties met meerdere beelden, stijloverdracht en iteratieve verfijning.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoer
text,image- Uitvoer
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten x-ai/grok-imagine-image-2.0 | 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— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten low, medium | 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} · daadwerkelijk teruggegeven task_id of 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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.08 schatting vóór generatie Deze raming is geen extra kost 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-2.0', '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 de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven 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-2.0
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · xAI: Grok Imagine Image 2.0
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:model,prompt,resolution,aspect_ratio,quality,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:n.minimum:1;n.maximum:1