xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 vytváří obrázky z písemných zadání a upravuje stávající obrázky pomocí pokynů v přirozeném jazyce. xAI dokumentuje nastavitelnou kvalitu, rozlišení a kompozici, více obrazových předloh, přenos stylu a postupné dolaďování.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Grok Imagine Image 2.0 je model společnosti xAI pro tvorbu a úpravy obrázků. Přijímá písemný popis, případně popis spolu se zdrojovými obrázky, a vrací obrazový výsledek. Pojmenovaný profil 2.0 výrobce zahrnuje tvorbu scény, změnu stávajícího obrázku, spojování motivů z předloh a proměnu vizuálního stylu. Nejprve si zvolte, zda potřebujete novou kompozici, nebo konkrétní změnu materiálu, který již máte.

Tvorba obrázku ze zadání

Popište hlavní motiv, jeho prostředí, kompozici, osvětlení a vizuální zpracování. Určete, čeho si má divák všimnout jako prvního a kde bude obrázek použit. U produktového konceptu může ilustrační zadání popsat keramickou stolní lampu na světlém kamenném stole, měkké světlo z okna, detail materiálu a volné místo pro samostatný nadpis. U ilustrace určete postavy, děj a zamýšlenou estetiku, místo abyste očekávali, že jediné označení stylu vymezí celou scénu.

Výrobce dokumentuje jeden až deset výstupních obrázků z požadavku na generování, s výchozí hodnotou jedna. Několik výsledků ze stejného zadání poskytuje varianty ke kontrole; nezaručuje totožný hlavní motiv v každé z nich. Zkontrolujte motiv, kompozici a důležité detaily a uchovejte verzi, která zadání vyhovuje nejlépe. Zadání a vybranou variantu uchovávejte společně, aby pozdější úpravy vycházely ze zamýšlené kompozice.

Kompozice, rozlišení a kvalita

Průvodce generováním dokumentuje automatickou volbu poměru stran nebo jeho výslovné zadání. Mezi uvedené možnosti patří 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 vybírejte podle zamýšleného umístění: čtverec pro kompaktní dlaždici, formát na výšku pro svislou kompozici nebo na šířku pro širokou scénu. Určete motiv citlivý na ořez a prostor potřebný pro rozvržení, nespoléhejte jen na poměr stran.

Dokumentovaná nastavení rozlišení při generování jsou 1k a 2k, přičemž výchozí je 1k. Kvalita je samostatný parametr s možnostmi low, medium a auto. V aktuálním průvodci xAI je výchozí auto, které používá low pro generování a medium pro úpravy; výslovné nastavení low nebo medium tuto volbu pevně určí. Rozlišení a kvalita tedy označují různé parametry. Uveďte vizuální detaily, na kterých záleží, a ověřte je ve vráceném obrázku, místo abyste kterékoli nastavení považovali za záruku přesných nápisů, geometrie nebo zachování hlavního motivu.

Úpravy a přenos vizuálního stylu

Dodejte obrázek, který se má změnit, a popište požadovanou změnu ve vztahu k jeho viditelnému obsahu. Cílená úprava může požadovat nahrazení tmavé stěny světlou omítkou při zachování rozmístění nábytku, pohledu kamery a teplého osvětlení. Pokud má jít o změnu stylu, určete požadované zpracování: výrobce předvádí fotografii, anime, olejomalbu, akvarel, pop-art a kresbu tužkou. Určete, které prvky mají zachovat svůj vzhled a které se mohou s novým zpracováním změnit.

Postup úprav výrobce přijímá odkaz na zdrojový obrázek, kódovaná obrazová data nebo identifikátor souboru. U uložených předloh použijte plně nahrané obrázky PNG, JPEG nebo WebP. Průvodce také dokumentuje navazující úpravy: výsledek jedné úpravy použijte jako vstup další. Základní kompozici tak lze proměnit v konkrétnější výsledek například změnou nábytku a následnou úpravou osvětlení. Původní i vybraný mezilehlý obrázek propojte s příslušným zadáním, aby bylo možné pozdější doladění porovnat se zamýšlenou kompozicí.

Kombinace více předloh

Aktuální průvodce pro více obrázků povoluje až pět zdrojových obrázků v jedné úpravě. Odkazujte na ně v dodaném pořadí a každému dejte jasnou roli, například hlavní motiv z prvního obrázku a prostředí z druhého. Výstupní poměr stran ve výchozím stavu sleduje první vstupní obrázek, lze jej však přepsat výslovným poměrem. U konceptu produktu v místnosti popište jeho polohu, velikost a kontakt s povrchy místnosti a poté požádejte o zachování rozpoznávacích detailů. Zkontrolujte, jak byly zdroje zkombinovány, místo abyste předpokládali, že byl každý prvek převzat beze změny.

Přijetí a uchování obrázku

Výrobce ve výchozím stavu vrací dočasnou adresu obrázku a dokumentuje také výstup s kódovaným obrázkem. Pokud má obrázek sloužit jako podklad, co nejdříve uložte skutečný soubor. Volitelný odložený postup odděluje potvrzení požadavku od dokončení: po identifikátoru požadavku následuje stav pending, done nebo failed a odložené výsledky používají formát odpovědi s adresou a dokumentovanou dobou uchování 24 hodin. Odeslaný požadavek ani stav pending nejsou hotovým obrázkem. Dokončený obrázek uchovejte se zadáním a zvolenými nastaveními pro pozdější využití.

Užitečným finálním výstupem je obrázek odpovídající konkrétnímu zadání scény, rozvržení nebo úpravy. Zkontrolujte celou kompozici i drobné detaily, zejména zdrojový motiv, hranice objektů, proporce a všechny nápisy, které nesou význam. Při postupných úpravách změňte pokyn související s viditelným problémem a vybraný výsledek použijte jako další předlohu. Požadovanou změnu i pokyny k zachování formulujte konkrétně, aby bylo možné každý výsledek posoudit podle jasného tvůrčí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

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity x-ai/grok-imagine-image-2.0	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1K, 2K	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	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	Výchozí—
Pole`quality`	Typ`string`	PožadavekVolitelné	Hodnoty a limity low, medium	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 1	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 3	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
Konfiguracevstupní obrázek	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza vstupní obrázek	Poplatek Vstup · vstupní obrázek · Odhad pouze pro srovnání $0.02 za vstupní obrázek
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.08 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo 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}

Další načtení obsahu

Načíst existující soubory, které vám patří

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.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

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

Aliasy

Aliasy modelu

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

Aliasy cest metod

/v1/images

Související ID modelů

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0