xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 luo kuvia kirjallisista briiffeistä ja muokkaa olemassa olevia kuvia luonnollisen kielen ohjeilla. xAI dokumentoi säädettävän laadun, tarkkuuden ja sommittelun, usean kuvan viitteet, tyylinsiirron ja iteratiivisen viimeistelyn.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Grok Imagine Image 2.0 on xAI:n kuvien luonti- ja muokkausmalli. Se vastaanottaa kirjallisen kuvauksen tai kuvauksen yhdessä lähtökuvien kanssa ja palauttaa kuvatuloksen. Valmistajan nimetty 2.0-profiili kattaa näkymän luomisen, olemassa olevan kuvan muuttamisen, kohteiden yhdistämisen viitekuvista ja visuaalisen tyylin muuntamisen. Valitse aluksi, tarvitsetko uuden sommittelun vai tietyn muutoksen jo olemassa olevaan aineistoon.

Kuvan luominen briiffistä

Kuvaile pääkohde, sen ympäristö, sommittelu, valaistus ja visuaalinen käsittely. Määritä, mitä katsojan tulee huomata ensimmäisenä ja missä kuvaa käytetään. Tuotekonseptin esimerkkibriiffi voi kuvailla keraamisen pöytävalaisimen vaalealla kivipöydällä, pehmeän ikkunavalon, materiaalin lähinäkymän ja vapaata tilaa erilliselle otsikolle. Määritä kuvitusta varten hahmot, toiminta ja tarkoitettu estetiikka sen sijaan, että odottaisit yhden tyylisanan määrittävän koko näkymän.

Valmistaja dokumentoi yhdestä kymmeneen tuloskuvaa luontipyyntöä kohti; oletuksena on yksi. Useat saman briiffin tulokset antavat vaihtoehtoja arvioitaviksi; ne eivät takaa samanlaista kohdetta jokaisessa variaatiossa. Tarkista kohde, sommittelu ja tärkeät yksityiskohdat ja säilytä sitten briiffiin parhaiten sopiva versio. Pidä briiffi ja valittu variaatio yhdessä, jotta myöhemmät muokkaukset käyttävät tarkoitettua sommittelua.

Sommittelu, tarkkuus ja laatu

Luontiopas dokumentoi automaattisen kuvasuhteen valinnan tai täsmällisen kuvasuhteen. Lueteltuja vaihtoehtoja ovat 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 ja 5:2. Valitse muoto käyttösijoittelun perusteella: neliö pienelle ruudulle, pysty pystysommittelulle tai vaaka laajalle näkymälle. Määritä rajaukselle herkkä kohde ja asettelun vaatima tila sen sijaan, että luottaisit pelkkään kuvasuhteeseen.

Dokumentoidut luontitarkkuuden asetukset ovat 1k ja 2k; oletus on 1k. Laatu on erillinen säätö, jonka vaihtoehdot ovat low, medium ja auto. xAI:n nykyisessä oppaassa auto on oletus ja käyttää luonnissa low-tasoa ja muokkauksessa medium-tasoa; erikseen asetettu low tai medium lukitsee kyseisen valinnan. Tarkkuus ja laatu kuvaavat siis eri säätöjä. Kerro tärkeät visuaaliset yksityiskohdat ja tarkista ne palautetusta kuvasta sen sijaan, että pitäisit kumpaakaan asetusta takuuna täsmällisistä teksteistä, geometriasta tai kohteen säilymisestä.

Muokkaus ja visuaalisen tyylin siirtäminen

Anna muutettava kuva ja kuvaile pyydetty muutos suhteessa sen näkyvään sisältöön. Rajattu muokkaus voi pyytää korvaamaan tumman seinän vaalealla rappauspinnalla säilyttäen kalusteiden asettelun, kameran näkökulman ja lämpimän valaistuksen. Jos tavoitteena on tyylimuunnos, määritä haluttu käsittely: valmistajan esimerkkeihin kuuluvat valokuvaus, anime, öljymaalaus, vesiväri, poptaide ja lyijykynäluonnos. Määritä, minkä elementtien ulkoasun tulee säilyä ja mitkä voivat muuttua käsittelyn mukana.

Valmistajan muokkaustyönkulku hyväksyy lähtökuvaviitteen, koodatun kuvadatan tai tiedostotunnisteen. Käytä tallennettuina viitteinä kokonaan ladattuja PNG-, JPEG- tai WebP-kuvia. Opas dokumentoi myös peräkkäiset muokkaukset: käytä yhden muokkauksen tulosta seuraavan syötteenä. Tämä voi kehittää pohjasommittelun täsmällisemmäksi tulokseksi kalustemuutoksen ja sitä seuraavan valaistuksen säädön kautta. Pidä alkuperäinen ja valittu välivaiheen kuva liitettyinä kuhunkin briiffiin, jotta myöhempää viimeistelyä voi tarkistaa tarkoitettua sommittelua vasten.

Useiden viitteiden yhdistäminen

Nykyinen usean kuvan opas sallii enintään viisi lähtökuvaa yhdessä muokkauksessa. Viittaa niihin annetussa järjestyksessä ja anna kullekin selkeä rooli, kuten kohde ensimmäisestä kuvasta ja ympäristö toisesta. Tuloksen kuvasuhde seuraa oletuksena ensimmäistä syötekuvaa, mutta sen voi ohittaa erikseen määritetyllä suhteella. Kuvaile tuote huoneessa -konseptia varten tuotteen sijainti, koko ja kosketus huoneen pintoihin ja pyydä sitten säilyttämään sen tunnistavat yksityiskohdat. Arvioi, miten lähtöaineistot yhdistettiin, sen sijaan että olettaisit jokaisen elementin kopioituneen muuttumattomana.

Kuvan vastaanottaminen ja säilyttäminen

Valmistaja palauttaa oletuksena tilapäisen kuvaosoitteen ja dokumentoi myös koodatun kuvatuloksen. Tallenna varsinainen kuva viipymättä, kun sitä tarvitaan aineistona. Valinnainen lykätty työnkulku erottaa pyynnön kuittauksen valmistumisesta: pyyntötunnistetta seuraa tila pending, done tai failed, ja lykätyt tulokset käyttävät osoitevastausmuotoa, jonka dokumentoitu säilytysaika on 24 tuntia. Lähetetty pyyntö tai pending-tila ei ole valmis kuva. Säilytä valmistunut kuva briiffin ja valittujen asetusten kanssa myöhempää käyttöä varten.

Hyödyllinen lopputuotos on kuva, joka sopii määritettyyn näkymä-, asettelu- tai muokkausbriiffiin. Tarkista koko sommittelu ja sen pienet yksityiskohdat, erityisesti lähtöaineiston kohde, esineiden rajat, mittasuhteet ja merkitystä kantavat tekstit. Muuta iteratiivisessa työssä näkyvään ongelmaan liittyvää ohjetta ja käytä valittua tulosta seuraavana viitteenä. Pidä haluttu muutos ja säilyttämisohjeet konkreettisina, jotta kutakin tulosta voi arvioida tiettyä luovaa tarkoitusta vasten.

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

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat x-ai/grok-imagine-image-2.0	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`resolution`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1K, 2K	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 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	Oletus—
Kenttä`quality`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat low, medium	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 3	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetsyötekuva	Hinnasto—	Ennustettu määrä—	Laskutusyksikkösyötekuvaa kohden	Veloitus Syöte · syötekuva · Arvio vain vertailua varten $0.02 syötekuvaa kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.08 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

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

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0