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.0Start
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ält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser x-ai/grok-imagine-image-2.0 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 1K, 2K | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Vä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ältquality | Typstring | KravValfritt | Värden & gränser low, medium | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 1 | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 3 | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, 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.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad 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 |
| Konfigurationindatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper indatabild | Avgift Indata · indatabild · Uppskattning endast för jämförelse $0.02 per indatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | 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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andra innehållsläsningar
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ält | Typ |
|---|---|
Fältcreated | Typ |
Fältdata[].url | Typ |
Fältdata[].b64_json | Typ |
Fältusage | Typ |
Alias
Modellalias
Ailoot Ultra x-ai/grok-imagine-image-2.0
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
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