xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 vytvára obrázky z písomných zadaní a upravuje existujúce obrázky pomocou pokynov v prirodzenom jazyku. xAI dokumentuje nastaviteľnú kvalitu, rozlíšenie a kompozíciu, referencie z viacerých obrázkov, prenos štýlu a priebežné dolaďovanie.

Ailoot Ultra · Obrázky POST /v1/images/generations x-ai/grok-imagine-image-2.0

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Grok Imagine Image 2.0 je model spoločnosti xAI na tvorbu a úpravu obrázkov. Prijíma písomný opis alebo opis spolu so zdrojovými obrázkami a vracia obrazový výsledok. Profil výrobcu s označením 2.0 zahŕňa tvorbu scény, zmenu existujúceho obrázka, kombinovanie objektov z referencií a premenu vizuálneho štýlu. Začnite rozhodnutím, či potrebujete novú kompozíciu alebo konkrétnu zmenu materiálu, ktorý už máte.

Tvorba obrázka zo zadania

Opíšte hlavný objekt, jeho prostredie, kompozíciu, osvetlenie a vizuálne spracovanie. Určte, čo si má divák všimnúť ako prvé a kde sa obrázok použije. Pri produktovom koncepte môže ukážkové zadanie opísať keramickú stolovú lampu na svetlom kamennom stole, mäkké svetlo z okna, detailný pohľad na materiál a voľný priestor na samostatný nadpis. Pri ilustrácii určte postavy, dej a zamýšľanú estetiku a neočakávajte, že celú scénu definuje jediné slovo označujúce štýl.

Výrobca dokumentuje jeden až desať výstupných obrázkov z požiadavky na generovanie, pričom predvolený počet je jeden. Viac výsledkov z rovnakého zadania poskytuje alternatívy na posúdenie; nezaručuje rovnaký objekt v každom variante. Skontrolujte objekt, kompozíciu a dôležité detaily a potom uchovajte verziu, ktorá najlepšie vyhovuje zadaniu. Zadanie a vybraný variant uchovávajte spolu, aby neskoršie úpravy používali zamýšľanú kompozíciu.

Kompozícia, rozlíšenie a kvalita

Príručka generovania dokumentuje automatický výber pomeru strán alebo explicitný pomer. Medzi uvedené možnosti patria 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 a 5:2. Tvar vyberte podľa zamýšľaného umiestnenia: štvorec pre kompaktnú dlaždicu, formát na výšku pre zvislú kompozíciu alebo na šírku pre širokú scénu. Uveďte objekt citlivý na orez a priestor, ktorý rozloženie potrebuje, a nespoliehajte sa iba na pomer strán.

Dokumentované nastavenia rozlíšenia pri generovaní sú 1k a 2k, pričom 1k je predvolené. Kvalita je samostatný ovládací prvok s možnosťami low, medium a auto. V aktuálnej príručke xAI je auto predvolené a používa low pri generovaní a medium pri úpravách; explicitné nastavenie low alebo medium túto voľbu pevne určí. Rozlíšenie a kvalita teda opisujú odlišné ovládacie prvky. Uveďte vizuálne detaily, na ktorých záleží, a skontrolujte ich vo vrátenom obrázku; ani jedno nastavenie nie je zárukou presných nápisov, geometrie alebo zachovania objektu.

Úpravy a prenos vizuálneho štýlu

Dodajte obrázok na úpravu a požadovanú zmenu opíšte vo vzťahu k jeho viditeľnému obsahu. Cielená úprava môže žiadať výmenu tmavej steny za svetlý omietnutý povrch a zároveň zachovanie rozmiestnenia nábytku, pohľadu kamery a teplého osvetlenia. Ak je zámerom premena štýlu, určte požadované spracovanie: výrobca ukazuje fotografiu, anime, olejomaľbu, akvarel, pop-art a skicu ceruzkou. Určte, ktoré prvky majú zachovať svoj vzhľad a ktoré sa môžu so spracovaním zmeniť.

Postup úprav výrobcu prijíma referenciu zdrojového obrázka, zakódované obrazové dáta alebo identifikátor súboru. Pri uložených referenciách používajte úplne nahrané obrázky PNG, JPEG alebo WebP. Príručka tiež dokumentuje postupné úpravy: výsledok jednej úpravy použite ako vstup ďalšej. Základná kompozícia sa tak môže zmenou nábytku a následnou úpravou osvetlenia premeniť na konkrétnejší výsledok. Ku každému zadaniu uchovajte pôvodný aj vybraný priebežný obrázok, aby bolo možné neskoršie doladenie porovnať so zamýšľanou kompozíciou.

Kombinovanie viacerých referencií

Aktuálna príručka pre viac obrázkov povoľuje v jednej úprave až päť zdrojových obrázkov. Odkazujte na ne v poradí, v akom ste ich dodali, a každému prideľte jasnú úlohu, napríklad objekt z prvého obrázka a prostredie z druhého. Výstupný pomer predvolene vychádza z prvého vstupného obrázka a možno ho prepísať explicitným pomerom. Pri koncepte produktu v miestnosti opíšte polohu produktu, veľkosť a kontakt s povrchmi miestnosti a potom požiadajte o zachovanie detailov, ktoré ho identifikujú. Skontrolujte spôsob kombinovania zdrojov a nepredpokladajte, že každý prvok bol skopírovaný bez zmeny.

Prijatie a uchovanie obrázka

Výrobca predvolene vracia dočasnú adresu obrázka a dokumentuje aj zakódovaný obrazový výstup. Ak obrázok potrebujete ako podklad, samotný obrázok bezodkladne uložte. Voliteľný odložený postup oddeľuje potvrdenie požiadavky od dokončenia: po identifikátore požiadavky nasleduje stav pending, done alebo failed a odložené výsledky používajú formát odpovede s adresou s dokumentovanou dobou uchovania 24 hodín. Odoslaná požiadavka ani stav pending nie sú hotovým obrázkom. Dokončený obrázok uchovajte so zadaním a vybranými nastaveniami na ďalšie použitie.

Užitočným konečným výstupom je obrázok, ktorý vyhovuje určenému zadaniu scény, rozloženia alebo úpravy. Skontrolujte celú kompozíciu aj malé detaily, najmä zdrojový objekt, hranice predmetov, proporcie a všetky nápisy nesúce význam. Pri priebežnej práci zmeňte pokyn súvisiaci s viditeľným problémom a vybraný výsledok použite ako ďalšiu referenciu. Požadovanú úpravu aj pokyny na zachovanie prvkov formulujte konkrétne, aby sa každý výsledok dal posúdiť podľa konkrétneho tvorivého účelu.

Ailoot Ultra · Obrázky 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

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity x-ai/grok-imagine-image-2.0	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1K, 2K	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 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	Predvolené—
Pole`quality`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity low, medium	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 1	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 3	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacia jednotka	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
Konfiguráciavstupný obrázok	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza vstupný obrázok	Poplatok Vstup · vstupný obrázok · Odhad iba na porovnanie $0.02 za vstupný obrázok
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.08 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

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

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

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

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0