modellen

xAI: Grok Imagine Image 2.0

Markdown · JSON

xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 maakt afbeeldingen op basis van geschreven briefings en bewerkt bestaande afbeeldingen met instructies in natuurlijke taal. xAI documenteert instelbare kwaliteit, resolutie en compositie, referenties met meerdere afbeeldingen, 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 het genereren en bewerken van afbeeldingen. Het ontvangt een geschreven beschrijving, of een beschrijving samen met bronafbeeldingen, en levert een beeldresultaat op. Het benoemde 2.0-profiel van de producent omvat het maken van een scène, het wijzigen van een bestaande afbeelding, het combineren van onderwerpen uit referenties en het transformeren van de visuele stijl. Bepaal eerst of je een nieuwe compositie nodig hebt of een specifieke wijziging van materiaal dat je al hebt.

Een afbeelding maken op basis van een briefing

Beschrijf het hoofdonderwerp, de omgeving, compositie, belichting en visuele uitwerking. Geef aan wat de kijker als eerste moet opmerken en waar de afbeelding wordt gebruikt. Voor een productconcept kan een voorbeeldbriefing een keramische bureaulamp op een lichtstenen tafel beschrijven, met zacht raamlicht, een detailaanzicht van het materiaal en vrije ruimte voor een afzonderlijke kop. Specificeer voor een illustratie de personages, handeling en beoogde esthetiek, in plaats van te verwachten dat één stijlwoord de hele scène bepaalt.

De producent documenteert één tot tien uitvoerafbeeldingen per generatieverzoek, met één als standaard. Meerdere resultaten van dezelfde briefing bieden alternatieven om te beoordelen; ze garanderen niet dat het onderwerp in elke variant identiek is. Controleer het onderwerp, de compositie en belangrijke details en bewaar vervolgens de versie die het best bij de briefing past. Houd de briefing en 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 zijn onder meer 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 aan welk onderwerp bij uitsnijden behouden moet blijven en welke ruimte de opmaak nodig heeft, in plaats van alleen op de beeldverhouding te vertrouwen.

De gedocumenteerde resolutie-instellingen voor generatie zijn 1k en 2k, met 1k als standaard. Kwaliteit is een afzonderlijke instelling met de keuzes low, medium en auto. In de huidige handleiding van xAI is auto de standaard en gebruikt deze low voor generatie en medium voor bewerking; een expliciete instelling low of medium legt die keuze vast. Resolutie en kwaliteit beschrijven dus verschillende instellingen. Benoem de visuele details die ertoe doen en controleer ze in de geleverde afbeelding, in plaats van een van beide instellingen als garantie voor exacte belettering, geometrie of behoud van het onderwerp te beschouwen.

Bewerken en visuele stijl overdragen

Lever de te wijzigen afbeelding aan en beschrijf de gevraagde wijziging in relatie tot de zichtbare inhoud. Een gerichte bewerking kan vragen om een donkere muur te vervangen door een licht gestuct oppervlak, met behoud van de meubelopstelling, het camerastandpunt en de warme verlichting. Als een stijltransformatie de bedoeling is, specificeer dan de gewenste uitwerking: de producent toont stijlen als fotografie, anime, olieverf, aquarel, popart en potloodschets. Geef aan welke elementen hetzelfde moeten blijven uitzien en welke met de stijl mogen veranderen.

De bewerkingsworkflow van de maker accepteert een verwijzing naar een bronafbeelding, gecodeerde beeldgegevens of een bestands-ID. Gebruik voor opgeslagen referenties volledig geüploade PNG-, JPEG- of WebP-afbeeldingen. De handleiding documenteert ook opeenvolgende bewerkingen: gebruik het resultaat van de ene bewerking als invoer voor de volgende. Zo kan een basiscompositie specifieker worden door eerst meubels te veranderen en daarna de belichting aan te passen. Houd het origineel en de gekozen tussenafbeelding gekoppeld aan elke briefing, zodat een latere verfijning aan de bedoelde compositie kan worden getoetst.

Meerdere referenties combineren

De huidige handleiding voor meerdere afbeeldingen staat maximaal vijf bronafbeeldingen in één bewerking toe. Verwijs ernaar in de aangeleverde volgorde en geef elk een duidelijke rol, bijvoorbeeld het onderwerp uit de eerste afbeelding en de omgeving uit de tweede. De uitvoerverhouding volgt standaard de eerste invoerafbeelding, met de mogelijkheid dit te overschrijven met een expliciete verhouding. Beschrijf voor een product-in-een-ruimte-concept de positie, grootte en het contact van het product met de oppervlakken in de ruimte en vraag vervolgens om behoud van de details die het herkenbaar maken. Beoordeel hoe de bronnen zijn gecombineerd, in plaats van aan te nemen dat elk element zonder wijziging is overgenomen.

De afbeelding ontvangen en bewaren

De producent levert standaard een tijdelijk afbeeldingsadres en documenteert ook uitvoer als gecodeerde afbeelding. Bewaar de daadwerkelijke afbeelding tijdig wanneer je deze als bestand nodig hebt. De optionele uitgestelde workflow scheidt de ontvangstbevestiging van het verzoek van de voltooiing: een verzoek-ID wordt gevolgd door de status pending, done of failed. Uitgestelde resultaten gebruiken het adresformaat als antwoord, met een gedocumenteerde bewaartermijn van 24 uur. Een ingediend verzoek of de status pending is geen voltooide afbeelding. Bewaar de voltooide afbeelding met de briefing en gekozen instellingen voor later hergebruik.

Een bruikbaar eindresultaat is een afbeelding die past bij een gedefinieerde briefing voor een scène, opmaak of bewerking. Controleer de volledige compositie en kleine details, vooral het brononderwerp, objectranden, verhoudingen en eventuele belettering met betekenis. Wijzig bij iteratief werk de instructie die bij het zichtbare probleem hoort en gebruik het gekozen resultaat als volgende referentie. Houd de gewenste wijziging en aanwijzingen 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.0

xAI /x-ai/grok-imagine-image-2.0

Aan de slag

Grok Imagine Image 2.0 maakt afbeeldingen op basis van geschreven briefings en bewerkt bestaande afbeeldingen met instructies in natuurlijke taal. xAI documenteert instelbare kwaliteit, resolutie en compositie, referenties met meerdere afbeeldingen, stijloverdracht en iteratieve verfijning.

Toegestane invoer
Tekst · Afbeeldingen
Resultaten
Afbeeldingen

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Afbeeldingen POST /v1/images/generations
Invoertypen
text, image
Uitvoertypen
image
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
x-ai/grok-imagine-image-2.0
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
VeldresolutionTypestringVereisteOptioneelWaarden en limieten
1K, 2K
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden 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—
VeldqualityTypestringVereisteOptioneelWaarden en limieten
low, medium
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 1
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 3
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, 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.

ConfiguratieTariefstaffelVerwachte hoeveelheidRekeneenheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte 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
ConfiguratieinvoerafbeeldingTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper invoerafbeeldingKosten
Invoer · invoerafbeelding · Schatting uitsluitend ter vergelijking $0.02 per invoerafbeelding
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieRekeneenheid—Kosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.08 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

curl
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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
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
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra x-ai/grok-imagine-image-2.0

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

x-ai/grok-imagine-image-2.0

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

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst