xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 kuria vaizdus iš rašytinių aprašų ir redaguoja esamus vaizdus natūralios kalbos instrukcijomis. xAI dokumentuoja konfigūruojamą kokybę, raišką ir kompoziciją, kelių vaizdų etalonus, stiliaus perkėlimą ir iteracinį tobulinimą.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Grok Imagine Image 2.0 yra xAI vaizdų generavimo ir redagavimo modelis. Jis priima rašytinį aprašymą arba aprašymą kartu su šaltinio vaizdais ir pateikia vaizdo rezultatą. Gamintojo įvardytas 2.0 profilis apima scenos kūrimą, esamo vaizdo keitimą, objektų iš etalonų jungimą ir vizualinio stiliaus transformavimą. Pradėkite pasirinkdami, ar reikia naujos kompozicijos, ar konkretaus jau turimos medžiagos pakeitimo.

Vaizdo kūrimas iš aprašo

Aprašykite pagrindinį objektą, jo aplinką, kompoziciją, apšvietimą ir vizualinį apdorojimą. Nurodykite, ką žiūrovas turi pastebėti pirmiausia ir kur vaizdas bus naudojamas. Produkto koncepcijai iliustratyvus aprašas gali nurodyti keramikinį stalinį šviestuvą ant šviesaus akmens stalo, minkštą lango šviesą, artimą medžiagos vaizdą ir laisvą vietą atskirai antraštei. Iliustracijai nurodykite veikėjus, veiksmą ir norimą estetiką, užuot tikėjęsi, kad vienas stiliaus žodis apibrėš visą sceną.

Gamintojas dokumentuoja nuo vieno iki dešimties išvesties vaizdų vienoje generavimo užklausoje; numatytoji reikšmė – vienas. Keli tos pačios užklausos rezultatai suteikia alternatyvų peržiūrai, bet negarantuoja vienodo objekto kiekviename variante. Patikrinkite objektą, kompoziciją ir svarbias detales, tada išsaugokite geriausiai aprašą atitinkančią versiją. Aprašą ir pasirinktą variantą laikykite kartu, kad vėlesnis redagavimas naudotų norimą kompoziciją.

Kompozicija, raiška ir kokybė

Generavimo vadovas dokumentuoja automatinį kraštinių santykio parinkimą arba aiškiai nurodytą santykį. Jo pasirinkimų sąraše yra 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 ir 5:2. Formą rinkitės pagal numatomą vietą: kvadratinę kompaktiškai kortelei, vertikalią vertikaliai kompozicijai arba horizontalią plačiai scenai. Nurodykite apkirpimui jautrų objektą ir maketui reikalingą erdvę, užuot pasikliovę vien kraštinių santykiu.

Dokumentuotos generavimo raiškos nuostatos yra 1k ir 2k; numatytoji – 1k. Kokybė yra atskiras valdiklis su low, medium ir auto pasirinkimais. Dabartiniame xAI vadove auto yra numatytoji reikšmė ir naudoja low generavimui bei medium redagavimui; aiški low arba medium nuostata užfiksuoja tą pasirinkimą. Todėl raiška ir kokybė aprašo skirtingus valdiklius. Nurodykite svarbias vizualines detales ir tikrinkite jas gautame vaizde, užuot laikę kurią nors nuostatą tikslių raidžių, geometrijos ar objekto išsaugojimo garantija.

Redagavimas ir vizualinio stiliaus perkėlimas

Pateikite keičiamą vaizdą ir aprašykite norimą pakeitimą jo matomo turinio atžvilgiu. Tikslinis redagavimas gali paprašyti pakeisti tamsią sieną šviesiu tinko paviršiumi, išsaugant baldų išdėstymą, kameros rakursą ir šiltą apšvietimą. Jei tikslas – stilistinė transformacija, nurodykite norimą apdorojimą: gamintojas demonstruoja fotografijos, anime, aliejinės tapybos, akvarelės, poparto ir pieštuko eskizo stilius. Įvardykite, kurie elementai turi išlaikyti išvaizdą ir kurie gali keistis kartu su apdorojimu.

Gamintojo redagavimo eiga priima šaltinio vaizdo nuorodą, užkoduotus vaizdo duomenis ar failo identifikatorių. Išsaugotiems etalonams naudokite visiškai įkeltus PNG, JPEG arba WebP vaizdus. Vadovas taip pat dokumentuoja nuoseklų redagavimą: vieno pakeitimo rezultatą naudokite kaip kito įvestį. Taip bazinę kompoziciją galima paversti konkretesniu rezultatu pirmiausia pakeitus baldus, tada pakoregavus apšvietimą. Originalą ir pasirinktą tarpinį vaizdą susiekite su kiekvienu aprašu, kad vėlesnį tobulinimą būtų galima patikrinti pagal norimą kompoziciją.

Kelių etalonų jungimas

Dabartinis kelių vaizdų vadovas leidžia iki penkių šaltinio vaizdų vienam redagavimui. Nurodykite juos pateikimo tvarka ir kiekvienam suteikite aiškų vaidmenį, pavyzdžiui, objektas iš pirmo vaizdo ir aplinka iš antro. Pagal numatymą išvesties santykis seka pirmą įvesties vaizdą, tačiau jį galima pakeisti aiškia santykio nuostata. Produkto kambaryje koncepcijai aprašykite produkto vietą, dydį ir sąlytį su kambario paviršiais, tada paprašykite išsaugoti jį identifikuojančias detales. Patikrinkite, kaip šaltiniai buvo sujungti, užuot manę, kad kiekvienas elementas nukopijuotas be pakeitimų.

Vaizdo gavimas ir išsaugojimas

Gamintojas pagal numatymą pateikia laikiną vaizdo adresą ir taip pat dokumentuoja užkoduoto vaizdo išvestį. Kai vaizdo reikia kaip medžiagos, nedelsdami išsaugokite patį vaizdą. Pasirenkama atidėta eiga atskiria užklausos priėmimą nuo užbaigimo: po užklausos identifikatoriaus gaunama pending, done arba failed būsena, o atidėti rezultatai naudoja adreso atsakymo formatą su dokumentuotu 24 valandų saugojimo laikotarpiu. Pateikta užklausa ar pending būsena nėra užbaigtas vaizdas. Užbaigtą vaizdą išsaugokite su aprašu ir pasirinktomis nuostatomis vėlesniam naudojimui.

Naudingas galutinis artefaktas yra vaizdas, atitinkantis apibrėžtos scenos, maketo ar redagavimo aprašą. Patikrinkite visą kompoziciją ir smulkias detales, ypač šaltinio objektą, objektų ribas, proporcijas ir bet kokius prasmingus užrašus. Iteraciniam darbui pakeiskite su matomu trūkumu susijusią instrukciją ir pasirinktą rezultatą naudokite kaip kitą etaloną. Norimo pakeitimo ir išsaugojimo instrukcijas išlaikykite konkrečias, kad kiekvieną rezultatą būtų galima vertinti pagal konkretų kūrybinį tikslą.

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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos x-ai/grok-imagine-image-2.0	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`resolution`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1K, 2K	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 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	Numatyta—
Laukas`quality`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos low, medium	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 3	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

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

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijaįvesties paveikslėlis	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž įvesties vaizdą	Mokestis Įvestis · įvesties vaizdas · Įvertis tik palyginimui $0.02 už įvesties vaizdą
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.08 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

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

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0