xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 ustvarja slike iz pisnih opisov in ureja obstoječe slike z navodili v naravnem jeziku. xAI dokumentira nastavljivo kakovost, ločljivost in kompozicijo, reference iz več slik, prenos sloga in postopno dodelavo.

Ailoot Ultra · Slike POST /v1/images/generations x-ai/grok-imagine-image-2.0

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Grok Imagine Image 2.0 je xAI-jev model za ustvarjanje in urejanje slik. Sprejme pisni opis ali opis skupaj z izvornimi slikami in vrne slikovni rezultat. Proizvajalčev poimenovani profil 2.0 pokriva ustvarjanje prizora, spreminjanje obstoječe slike, združevanje motivov iz referenc in preoblikovanje vizualnega sloga. Najprej izberite, ali potrebujete novo kompozicijo ali konkretno spremembo gradiva, ki ga že imate.

Ustvarjanje slike iz opisa

Opišite glavni motiv, njegovo okolje, kompozicijo, osvetlitev in vizualno obdelavo. Določite, kaj naj gledalec opazi najprej in kje bo slika uporabljena. Za koncept izdelka lahko vzorčni opis navede keramično namizno svetilko na svetli kamniti mizi, mehko svetlobo okna, bližnji pogled na material in prazen prostor za ločen naslov. Pri ilustraciji določite like, dejanje in predvideno estetiko, namesto da pričakujete, da bo ena slogovna beseda opredelila celoten prizor.

Proizvajalec dokumentira od ene do deset izhodnih slik iz zahteve za ustvarjanje, s privzeto vrednostjo ena. Več rezultatov iz istega opisa zagotavlja alternative za pregled; ne jamčijo enakega motiva v vsaki različici. Preverite motiv, kompozicijo in pomembne podrobnosti, nato pa ohranite različico, ki najbolje ustreza opisu. Opis in izbrano različico hranite skupaj, da bodo poznejši popravki uporabljali predvideno kompozicijo.

Kompozicija, ločljivost in kakovost

Vodnik za ustvarjanje dokumentira samodejno izbiro razmerja stranic ali izrecno razmerje. Navedene možnosti vključujejo 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 in 5:2. Obliko izberite glede na predvideno mesto uporabe: kvadrat za manjšo ploščico, pokončni format za navpično kompozicijo ali ležeči za širok prizor. Določite motiv, občutljiv na obrezovanje, in prostor, ki ga postavitev potrebuje, namesto da se zanašate le na razmerje stranic.

Dokumentirani nastavitvi ločljivosti ustvarjanja sta 1k in 2k, pri čemer je privzeta 1k. Kakovost je ločena nastavitev z možnostmi low, medium in auto. V trenutnem vodniku xAI je auto privzeta možnost in uporablja low za ustvarjanje ter medium za urejanje; izrecna nastavitev low ali medium utrdi to izbiro. Ločljivost in kakovost torej opisujeta različni nastavitvi. Navedite pomembne vizualne podrobnosti in jih preverite v vrnjeni sliki, namesto da katerokoli nastavitev obravnavate kot jamstvo natančnih napisov, geometrije ali ohranitve motiva.

Urejanje in prenašanje vizualnega sloga

Priložite sliko, ki naj se spremeni, in zahtevano spremembo opišite glede na njeno vidno vsebino. Ciljni popravek lahko zahteva zamenjavo temne stene s svetlo ometano površino ter ohranitev razporeditve pohištva, zornega kota kamere in tople osvetlitve. Če je namen slogovno preoblikovanje, določite želeno obdelavo: proizvajalec prikazuje fotografijo, anime, oljno sliko, akvarel, pop art in slog skice s svinčnikom. Določite, kateri elementi naj ohranijo videz in kateri se lahko z obdelavo spremenijo.

Proizvajalčev postopek urejanja sprejema referenco izvorne slike, kodirane slikovne podatke ali identifikator datoteke. Za shranjene reference uporabite v celoti naložene slike PNG, JPEG ali WebP. Vodnik dokumentira tudi zaporedne popravke: rezultat enega urejanja uporabite kot vhod naslednjega. Tako lahko osnovno kompozicijo z zamenjavo pohištva in nato prilagoditvijo osvetlitve pretvorite v bolj določen rezultat. Izvirnik in izbrano vmesno sliko povežite z vsakim opisom, da lahko poznejšo dodelavo preverite glede na predvideno kompozicijo.

Združevanje več referenc

Trenutni vodnik za več slik dovoljuje do pet izvornih slik pri enem urejanju. Nanje se sklicujte v vrstnem redu, v katerem so podane, in vsaki določite jasno vlogo, denimo motiv s prve slike in okolje z druge. Izhodno razmerje privzeto sledi prvi vhodni sliki, lahko pa ga preglasite z izrecnim razmerjem. Pri konceptu izdelka v sobi opišite položaj, velikost in stik izdelka s površinami prostora, nato zahtevajte ohranitev podrobnosti, po katerih je prepoznaven. Preverite, kako so bili viri združeni, namesto da predpostavljate, da je bil vsak element kopiran brez sprememb.

Prejem in hramba slike

Proizvajalec privzeto vrne začasni naslov slike, dokumentira pa tudi kodirani slikovni izhod. Dejanske slike pravočasno shranite, kadar jih potrebujete kot gradivo. Njegov izbirni odloženi postopek ločuje potrditev zahteve od dokončanja: identifikatorju zahteve sledi stanje pending, done ali failed, odloženi rezultati pa uporabljajo obliko odgovora z naslovom in dokumentirano obdobje hrambe 24 ur. Oddana zahteva ali stanje pending nista dokončana slika. Dokončano sliko hranite skupaj z opisom in izbranimi nastavitvami za poznejšo ponovno uporabo.

Uporaben končni izdelek je slika, ki ustreza določenemu opisu prizora, postavitve ali popravka. Preglejte celotno kompozicijo in drobne podrobnosti, zlasti izvorni motiv, robove predmetov, razmerja in napise, ki nosijo pomen. Pri postopnem delu spremenite navodilo, povezano z vidno težavo, in izbrani rezultat uporabite kot naslednjo referenco. Želena sprememba in navodila za ohranitev naj ostanejo konkretna, da je mogoče vsak rezultat oceniti glede na določen ustvarjalni namen.

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

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve x-ai/grok-imagine-image-2.0	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`resolution`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1K, 2K	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 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	Privzeto—
Polje`quality`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve low, medium	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 1	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 3	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`material_types`	Specifikacijatext, image

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
Nastavitevvhodna slika	Cenovna lestvica—	Predvidena količina—	Obračunska enotana vhodno sliko	Strošek Vhod · vhodna slika · Ocena samo za primerjavo $0.02 na vhodno sliko
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.08 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0