models

xAI: Grok Imagine Image 2.0

Markdown · JSON

xAI: Grok Imagine Image 2.0

A Grok Imagine Image 2.0 írásos leírásból készít képeket, és természetes nyelvű utasításokkal szerkeszt meglévő képeket. Az xAI beállítható minőséget, felbontást és kompozíciót, több képreferenciát, stílusátvitelt és ismétlődő finomítást dokumentál.

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A Grok Imagine Image 2.0 az xAI képalkotó és képszerkesztő modellje. Írásos leírást, vagy leírást és forrásképeket fogad, és képi eredményt ad vissza. A gyártó név szerint megadott 2.0 profilja jelenet létrehozását, meglévő kép módosítását, referenciák témáinak kombinálását és a vizuális stílus átalakítását fedi le. Először válassza ki, hogy új kompozícióra vagy egy már rendelkezésre álló anyag konkrét módosítására van-e szüksége.

Képkészítés leírásból

Írja le a főtémát, annak környezetét, a kompozíciót, a világítást és a vizuális megjelenítést. Határozza meg, mit vegyen észre először a néző, és hol használják majd a képet. Termékkoncepciónál egy szemléltető leírás megadhat egy kerámia asztali lámpát halvány kőasztalon, lágy ablakfénnyel, az anyagot közelről bemutató nézettel és egy külön címsornak fenntartott üres hellyel. Illusztrációnál határozza meg a szereplőket, a cselekményt és a kívánt esztétikát, ne várja, hogy egyetlen stílust jelölő szó az egész jelenetet meghatározza.

A gyártó egy generálási kéréshez egytől tízig terjedő számú kimeneti képet dokumentál; az alapértelmezés egy. Az ugyanabból a leírásból származó több eredmény értékelhető alternatívákat kínál, de nem garantál azonos témát minden változatban. Ellenőrizze a témát, a kompozíciót és a fontos részleteket, majd tartsa meg a leíráshoz legjobban illeszkedő változatot. A leírást és a kiválasztott változatot együtt őrizze meg, hogy a későbbi szerkesztések a kívánt kompozíciót használják.

Kompozíció, felbontás és minőség

A generálási útmutató automatikus képarányválasztást vagy explicit aránymegadást dokumentál. A felsorolt lehetőségek: 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 és 5:2. A formát a tervezett elhelyezéshez válassza: négyzetest kompakt csempéhez, állót függőleges kompozícióhoz, fekvőt széles jelenethez. A vágásra érzékeny témát és az elrendezéshez szükséges helyet is határozza meg, ne kizárólag a képarányra hagyatkozzon.

A dokumentált generálási felbontások 1k és 2k, az alapértelmezés 1k. A minőség külön vezérlő, low, medium és auto értékekkel. Az xAI jelenlegi útmutatójában az auto az alapértelmezés, amely generálásnál low, szerkesztésnél medium minőséget használ; az explicit low vagy medium érték rögzíti az adott választást. A felbontás és a minőség tehát külön vezérlőket jelöl. Adja meg a fontos vizuális részleteket, és ellenőrizze őket a kapott képen, ne tekintse egyik beállítást sem a pontos feliratok, geometria vagy témamegőrzés garanciájának.

Szerkesztés és vizuális stílus átvitele

Adja meg a módosítandó képet, és a látható tartalmához viszonyítva írja le a kért változtatást. Célzott szerkesztés lehet például egy sötét fal világos vakolatfelületre cserélése, a bútorok elrendezésének, a kamera nézőpontjának és a meleg megvilágításnak a megőrzésével. Ha stílusátalakítás a cél, határozza meg a kívánt megjelenítést: a gyártó fényképészeti, anime-, olajfestmény-, akvarell-, pop-art- és ceruzavázlat-stílusokat mutat be. Jelölje meg, mely elemeknek kell megőrizniük a megjelenésüket, és melyek változhatnak az ábrázolásmóddal együtt.

A gyártó szerkesztési munkafolyamata forráskép-hivatkozást, kódolt képadatot vagy fájlazonosítót fogad. Tárolt referenciákhoz teljesen feltöltött PNG-, JPEG- vagy WebP-képeket használjon. Az útmutató egymást követő szerkesztéseket is dokumentál: az egyik szerkesztés eredményét használja a következő bemeneteként. Így az alapkompozíció például bútorcserével, majd világításmódosítással egyre pontosabb eredménnyé alakítható. Az eredeti és a kiválasztott köztes képet kapcsolja minden leíráshoz, hogy a későbbi finomítást a kívánt kompozícióhoz lehessen ellenőrizni.

Több referencia kombinálása

A jelenlegi többképes útmutató egy szerkesztésben legfeljebb öt forrásképet engedélyez. A megadott sorrendjük szerint hivatkozzon rájuk, és mindegyiknek adjon egyértelmű szerepet, például az első képről a téma, a másodikról a környezet származzon. A kimenet aránya alapértelmezésben az első bemeneti képet követi, de explicit aránnyal felülírható. Szobába helyezett termékkoncepciónál írja le a termék helyzetét, méretét és kapcsolatát a helyiség felületeivel, majd kérje az azonosító részletek megőrzését. Ellenőrizze, hogyan kapcsolódtak össze a források, ne feltételezze, hogy minden elem változtatás nélkül átmásolódott.

A kép fogadása és megőrzése

A gyártó alapértelmezésben ideiglenes képcímet ad vissza, és kódolt képkimenetet is dokumentál. Ha a kép felhasználandó anyag, a tényleges fájlt mielőbb mentse el. Az opcionális halasztott munkafolyamat különválasztja a kérés visszaigazolását és befejezését: a kérésazonosítót pending, done vagy failed állapot követi, a halasztott eredmények pedig címet tartalmazó válaszformátumot használnak, dokumentált 24 órás megőrzési idővel. A beküldött kérés vagy a pending állapot még nem kész kép. A befejezett képet őrizze meg a leírással és a kiválasztott beállításokkal a későbbi újrafelhasználáshoz.

Használható végső eredmény az a kép, amely illeszkedik egy meghatározott jelenethez, elrendezéshez vagy szerkesztési leíráshoz. Ellenőrizze a teljes kompozíciót és az apró részleteket, különösen a forrástémát, a tárgyak határait, az arányokat és a jelentést hordozó feliratokat. Ismétlődő munkánál a látható problémához kapcsolódó utasítást módosítsa, és a kiválasztott eredményt használja a következő referenciaként. A kívánt módosítás és a megőrzési utasítások legyenek konkrétak, hogy minden eredményt egy meghatározott kreatív célhoz lehessen mérni.

Ailoot Ultra · Képek 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

Kezdő lépések

A Grok Imagine Image 2.0 írásos leírásból készít képeket, és természetes nyelvű utasításokkal szerkeszt meglévő képeket. Az xAI beállítható minőséget, felbontást és kompozíciót, több képreferenciát, stílusátvitelt és ismétlődő finomítást dokumentál.

Elfogadott bemenetek
Szöveg · Képek
Eredmények
Képek

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Képek POST /v1/images/generations
Bemenet
text, image
Kimenet
image
MezőTípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
x-ai/grok-imagine-image-2.0
Alapértelmezett—
MezőpromptTípusstringKövetelményKötelezőÉrtékek és korlátok
Minimális hossz: 1
Alapértelmezett—
MezőresolutionTípusstringKövetelményOpcionálisÉrtékek és korlátok
1K, 2K
Alapértelmezett—
Mezőaspect_ratioTípusstringKövetelményOpcionálisÉrtékek és korlátok
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
Alapértelmezett—
MezőqualityTípusstringKövetelményOpcionálisÉrtékek és korlátok
low, medium
Alapértelmezett—
MezőnTípusintegerKövetelményOpcionálisÉrtékek és korlátok
Minimum: 1
Maximum: 1
Alapértelmezett—
Mezőinput_referencesTípusarrayKövetelményOpcionálisÉrtékek és korlátok
Minimális elemszám: 0
Maximális elemszám: 3
Alapértelmezett—
MezőproviderTípusobjectKövetelményOpcionálisÉrtékek és korlátokAlapértelmezett—
Metódus paraméterei és életciklusa
ParaméterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, prompt
Paramétermaterial_typesSzerződéstext, image

Életciklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód
Nincs megadva Ha a gyors mód van kiválasztva
Flex mód
Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás
Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

BeállításDíjtáblázatElőre jelzett mennyiségElszámolási egységDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElőre jelzett mennyiség—Elszámolási egység—Díj
Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
Beállításbemeneti képDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységbemeneti képenkéntDíj
Bemenet · bemeneti kép · Becslés, csak összehasonlításra $0.02 bemeneti képenként
BeállításA generálás becsült költségeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraElszámolási egység—Díj
Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.08 becslés a generálás előtt

Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Képek

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

Eredmények fogadása és mentése

Ailoot Ultra · Képek

Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
További tartalomlekérések
A meglévő, Önhöz tartozó médiafájlok lekérése
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.
Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.

Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.

Ha az eredeti választ ellenőrizni kell

Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.

Válaszmezők
MezőTípus
MezőcreatedTípus
Meződata[].urlTípus
Meződata[].b64_jsonTípus
MezőusageTípus

Álnevek

Modell álnevei

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

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0
Milyen bemenetek és eredmények érhetők el?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image

Mely mezőket használja a kérés?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider

Milyen korlátok érvényesek?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

További részletek

Csatlakoztassa az Ailootot a Claude Code-hoz, OpenCode-hoz, Hermeshez vagy saját alkalmazásához.

A vállalat és projektportfóliója

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

Vásároljon tokeneket kedvezménnyel.

Előfizetési kedvezmény rendszeres munkához. Promókódok — akár 50% tokenvásárlási kedvezmény.

Előfizetés
Válasszon kedvezményes tarifát a rendszeres kéréseihez.
Promókód akár 50%-ig
Vásárláskor adja meg a kódot. Az ár az érvényes akció szerint újraszámolódik.
Költségek az előzményekben
Minden kéréshez megmarad a modell, a tokenek és az összeg.

Előfizetés kiválasztása · Modellárak megtekintése

Csatlakoztassa az API-t az értékesített termékéhez.

SaaS, alkalmazások és botok — az Ailoot ajánlati feltételei és licencszerződése alapján. Viszonteladáshoz kérjen viszonteladói licencet.

Kereskedelmi alkalmazás
Építsen szöveg-, kép-, videó- és hanggenerálást szolgáltatása fizetős funkcióiba.
Viszonteladói licenc
Küldje el a projekt leírását és a hozzáférés módját. Kérjen írásos használati és viszonteladási feltételeket.
Dokumentumok a weboldalon
Az ajánlati feltételek, licencszerződés és adatkezelési szabályzat már a csatlakoztatás előtt elérhető.

Viszonteladói licenc kérése · Ajánlati feltételek és licencszerződés