SpaceXAI: Grok Imagine Image Quality

Grok Imagine Image Quality generuoja ir redaguoja vaizdus, daug dėmesio skirdamas realizmui, teksto atvaizdavimui ir kūrybiniam valdymui. Naudokite tikslų tekstinį aprašą ir pasirenkamus etalonus produktų vaizdams, kampanijų medžiagai, piktogramoms ar tikslinei esamo paveikslo pataisai kurti.

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

Apie modelį

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

Grok Imagine Image Quality yra atskirai įvardytas SpaceXAI vaizdų generavimo ir redagavimo modelis, orientuotas į tikroviškas detales, geresnį teksto atvaizdavimą ir tikslų kūrybinio aprašo laikymąsi. Jis priima tekstą ir pasirenkamus vaizdų etalonus bei pateikia vaizdą. Taikymo sritys apima produktų vizualizavimą, kampanijų kūrybinę medžiagą, socialinių tinklų vaizdus, iliustracijas ir sąsajos stiliaus piktogramas; stilių spektras apima fotografinę bei kinematografinę medžiagą ir grafinę kūrybą.

Produkto scenai prieš pridėdami dekoratyvų stilių aprašykite objektą, išdėstymą, medžiagą, apšvietimą ir kameros rakursą. Pateikite etaloną, kai produkto forma ar užrašai turi likti atpažįstami. Naudingas aprašas gali ant akmens paviršiaus padėti mažą butelį su etikete, nustatyti paletę ir palikti vietos antraštei. Piktogramai ar grafikai nurodykite formą, kontrastą ir numatomą vizualinį mastelį. Rezultatas yra atvaizduotas paveikslas, o ne veikianti sąsaja ar redaguojamas maketo failas.

Redagavimas prie instrukcijos prideda šaltinio vaizdą. Gamintojo eigoje išsaugoti vaizdų etalonai turi būti visiškai įkelti ir naudoti PNG, JPEG arba WebP. Įvardykite pakeitimą ir tai, ką reikia išsaugoti: naują foną, kitą medžiagą, tikslinę stiliaus transformaciją ar pataisytą užrašą. Kai prie kompozicijos prisideda keli etalonai, jų vaidmenis aprašykite atskirai, pavyzdžiui, produktas iš vieno paveikslo ir prekės ženklo išvaizda iš kito. Išlaikykite pradinį produkto etaloną, kad vėlesnės pataisos neprarastų pirmajame kūrinyje nustatytos tapatybės.

Praktiška seka gali prasidėti produkto atvaizdu ir vėliau tą patį vaizdą perkelti į kitą aplinką ar spaudos kompoziciją. Pasirinktą rezultatą naudokite kaip kito redagavimo įvestį ir naują instrukciją sutelkite į transformaciją. Kampanijos variantui išsaugokite sėkmingą objektą ir hierarchiją, keisdami aplinką ar papildomą tekstą. Taip vaizdas plėtojamas aiškiais etapais, užuot tikėjusis, kad vėlesnė užklausa prisimins ankstesnę nepateiktą medžiagą.

Tipografija ir smulkios tekstūros yra Quality modelio kūrybinio dėmesio dalis. Meniu, etiketei ar reklamai pateikite tikslius žodžius, skaitmenis ir vietą, taip pat aprašykite, kaip tekstas turi derėti prie medžiagos ar kompozicijos. Tikrinkite rašybą, skaitymo tvarką ir smulkias raides tikruoju rodymo dydžiu. Tikroviška tekstūra gali sustiprinti produkto vizualinį pateikimą, tačiau faktinės produkto savybės vis tiek turi būti iš patvirtinto aprašo ir etalonų.

Gamintojo vaizdų eiga palaiko 1K ir 2K raiškos pasirinkimus bei horizontalias, kvadratines ar vertikalias kompozicijas, su automatiniu kraštinių santykio parinkimu, kai jis nenurodytas. Vaizdo formą rinkitės pagal objektą ir teksto vietą, užuot laikę raišką maketo pakaitalu. Kelias alternatyvas galima užsakyti bendru vaizdų generavimo skaičiaus parametru, kurio ribos yra nuo vieno iki dešimties, o numatytoji reikšmė – vienas. Alternatyvų palyginimas naudingas renkantis kompoziciją, bet neįrodo, kad kiekviename rezultate yra visos prašytos detalės.

Vaizdai paprastai pateikiami per laikinas prieglobos vietas, o base64 pateikimas galimas, kai vaizdą reikia tiesiogiai įtraukti į programos artefaktą. Išsaugokite tikrą pasirinktą medžiagą, užuot laikę laikiną vietą vienintele projekto kopija. Gamintojo vaizdo failų integracijoje taip pat parodomas išsaugotų vaizdų identifikatorių naudojimas kaip etalonų ir sugeneruotų vaizdo failų saugojimas vėlesniam naudojimui. Šie pateikimo ir saugojimo pasirinkimai yra atskiri nuo vizualinio aprašo, nustatančio, ką vaizdas turi rodyti.

Atskirai įvardytas Image Quality modelis skiriasi nuo Grok Imagine Image 2.0 kokybės parametro low, medium ir auto reikšmių. Šių vėlesnių kokybės valdiklių ir išplėstų etalonų ar kraštinių santykių pasirinkimų nereikia laikyti šio profilio nuostatomis. Kelių alternatyvų užsakymas vienu vaizdų kvietimu taip pat skiriasi nuo gamintojo Batch API, kurio konkrečiame Quality modelio puslapyje nėra tarp palaikomų funkcijų. Rengdami pakartojamą eigą laikykite susietus vaizdo modelio pasirinkimą, užklausą, etalonus ir pasirinktą rezultatą.

Norėdami naudingo galutinio vaizdo, palyginkite prašytą sceną, produkto detales, tipografiją ir išsaugotus elementus su aprašu, tada pataisykite konkrečią tikslo nepasiekusią dalį. Sugeneruotas statiškas vaizdas gali tapti atskiros vaizdo įrašo užduoties etalonu, tačiau paties vaizdų modelio artefaktas lieka vaizdas. Išsaugokite sėkmingą versiją ir etaloninę medžiagą, kad vėlesnis kampanijos redagavimas ar vietos pakeitimas galėtų tobulinti tą pačią kūrybinę kryptį.

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

x-ai/grok-imagine-image-quality

SpaceXAI /x-ai/grok-imagine-image-quality

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-quality	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`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.1 į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-quality', '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-quality

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

x-ai/grok-imagine-image-quality

FAQ · SpaceXAI: Grok Imagine Image Quality

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

SpaceXAI: Grok Imagine Image Quality