modeller

xAI: Grok Imagine Image 2.0

Markdown · JSON

xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 skapar bilder från skriftliga briefer och redigerar befintliga bilder med instruktioner på naturligt språk. xAI dokumenterar konfigurerbar kvalitet, upplösning och komposition, referenser med flera bilder, stilöverföring och iterativ förfining.

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Grok Imagine Image 2.0 är xAI:s modell för bildgenerering och bildredigering. Den tar emot en skriftlig beskrivning, eller en beskrivning tillsammans med källbilder, och returnerar ett bildresultat. Producentens namngivna 2.0-profil omfattar att skapa en scen, ändra en befintlig bild, kombinera motiv från referenser och omvandla visuell stil. Börja med att välja om du behöver en ny komposition eller en specifik ändring av material som du redan har.

Skapa en bild från en brief

Beskriv huvudmotivet, dess miljö, kompositionen, ljussättningen och det visuella uttrycket. Ange vad betraktaren ska lägga märke till först och var bilden ska användas. För ett produktkoncept kan en illustrativ brief beskriva en skrivbordslampa i keramik på ett ljust stenbord, mjukt fönsterljus, en närbild av materialet och tomt utrymme för en separat rubrik. För en illustration anger du karaktärer, handling och avsedd estetik i stället för att förvänta dig att ett enda stilord definierar hela scenen.

Producenten dokumenterar ett till tio bildresultat från en genereringsbegäran, med ett som standard. Flera resultat från samma brief ger alternativ att granska; de garanterar inte ett identiskt motiv i varje variant. Kontrollera motiv, komposition och viktiga detaljer och behåll sedan den version som bäst passar briefen. Håll ihop briefen och den valda varianten så att senare redigeringar använder den avsedda kompositionen.

Komposition, upplösning och kvalitet

Genereringsguiden dokumenterar automatiskt val av bildförhållande eller ett uttryckligt förhållande. De angivna valen omfattar 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 och 5:2. Välj formen utifrån den avsedda placeringen: kvadratisk för en kompakt ruta, stående för en vertikal komposition eller liggande för en bred scen. Ange det beskärningskänsliga motivet och det utrymme layouten behöver i stället för att enbart förlita dig på bildförhållandet.

De dokumenterade inställningarna för genereringsupplösning är 1k och 2k, med 1k som standard. Kvalitet är en separat kontroll med valen low, medium och auto. I xAI:s aktuella guide är auto standard och använder low för generering och medium för redigering; en uttrycklig inställning på low eller medium låser det valet. Upplösning och kvalitet beskriver därmed olika kontroller. Ange de visuella detaljer som är viktiga och granska dem i den returnerade bilden i stället för att behandla någon av inställningarna som en garanti för exakt text, geometri eller bevarande av motiv.

Redigera och överföra visuell stil

Tillhandahåll bilden som ska ändras och beskriv den begärda ändringen i förhållande till dess synliga innehåll. En avgränsad redigering kan be om att ersätta en mörk vägg med en ljus putsad yta samtidigt som möbleringen, kamerans perspektiv och den varma belysningen bevaras. Om avsikten är en stilomvandling anger du det önskade uttrycket: producenten visar fotografi, anime, oljemålning, akvarell, popkonst och blyertsskiss. Ange vilka element som ska behålla sitt utseende och vilka som får ändras med uttrycket.

Tillverkarens redigeringsflöde tar emot en källbildsreferens, kodade bilddata eller en filidentifierare. För lagrade referenser använder du fullständigt uppladdade PNG-, JPEG- eller WebP-bilder. Guiden dokumenterar också successiva redigeringar: använd resultatet av en redigering som indata till nästa. Detta kan omvandla en grundkomposition till ett mer specifikt resultat genom ett möbelbyte följt av en justering av ljussättningen. Håll originalet och den valda mellanliggande bilden kopplade till varje brief så att en senare förfining kan kontrolleras mot den avsedda kompositionen.

Kombinera flera referenser

Den aktuella guiden för flera bilder tillåter upp till fem källbilder i en redigering. Hänvisa till dem i den ordning de tillhandahållits och ge var och en en tydlig roll, till exempel motivet från den första bilden och miljön från den andra. Utmatningsförhållandet följer den första indatabilden som standard, med ett uttryckligt förhållande tillgängligt för att åsidosätta det. För ett koncept med en produkt i ett rum beskriver du produktens position, storlek och kontakt med rummets ytor och ber sedan om att bevara de detaljer som identifierar den. Granska hur källorna kombinerades i stället för att anta att varje element kopierades utan ändring.

Ta emot och bevara bilden

Producenten returnerar en tillfällig bildadress som standard och dokumenterar också utdata som kodad bild. Spara den faktiska bilden skyndsamt när den behövs som tillgång. Det valfria uppskjutna arbetsflödet skiljer bekräftelse av begäran från slutförande: en identifierare för begäran följs av status pending, done eller failed, och uppskjutna resultat använder adressformatet för svar med en dokumenterad lagringstid på 24 timmar. En inskickad begäran eller status pending är inte en färdig bild. Spara den färdiga bilden med dess brief och valda inställningar för senare återanvändning.

En användbar slutartefakt är en bild som passar en definierad scen-, layout- eller redigeringsbrief. Granska hela kompositionen och dess små detaljer, särskilt källmotivet, objektgränser, proportioner och all text som bär betydelse. Vid iterativt arbete ändrar du instruktionen kopplad till det synliga problemet och använder det valda resultatet som nästa referens. Håll den önskade ändringen och bevarandeinstruktionerna konkreta så att varje resultat kan bedömas mot ett specifikt kreativt syfte.

Ailoot Ultra · Bilder 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

Start

Grok Imagine Image 2.0 skapar bilder från skriftliga briefer och redigerar befintliga bilder med instruktioner på naturligt språk. xAI dokumenterar konfigurerbar kvalitet, upplösning och komposition, referenser med flera bilder, stilöverföring och iterativ förfining.

Godkända indata
Text · Bilder
Resultat
Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations
Indatatyper
text, image
Utdatatyper
image
FältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
x-ai/grok-imagine-image-2.0
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Standard—
FältresolutionTypstringKravValfrittVärden & gränser
1K, 2K
Standard—
Fältaspect_ratioTypstringKravValfrittVärden & gränser
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
Standard—
FältqualityTypstringKravValfrittVärden & gränser
low, medium
Standard—
FältnTypintegerKravValfrittVärden & gränser
Minimum: 1
Maximum: 1
Standard—
Fältinput_referencesTyparrayKravValfrittVärden & gränser
Minsta antal objekt: 0
Maximalt antal objekt: 3
Standard—
FältproviderTypobjectKravValfrittVärden & gränserStandard—
Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext, image

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge
Ej angivet När snabbt läge är valt
Flex-läge
Ej angivet När läget flex är valt
Högsta resonemangsnivå
Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

KonfigurationPrislistaPrognostiserad mängdDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad mängd—Debiteringsenhet—Avgift
Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token
Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token
Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationindatabildPrislista—Prognostiserad mängd—Debiteringsenhetper indatabildAvgift
Indata · indatabild · Uppskattning endast för jämförelse $0.02 per indatabild
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringDebiteringsenhet—Avgift
Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.08 uppskattning före generering

Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Bilder

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

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Andra innehållsläsningar
Läs befintliga resurser som tillhör dig
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.
Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält
FältTyp
FältcreatedTyp
Fältdata[].urlTyp
Fältdata[].b64_jsonTyp
FältusageTyp

Alias

Modellalias

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

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0
Vilka indata och resultat finns?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image

Vilka fält använder begäran?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider

Vilka gränser gäller?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal