SpaceXAI: Grok Imagine Image Quality
Grok Imagine Image Quality vytvára a upravuje obrázky s dôrazom na realizmus, vykresľovanie textu a tvorivú kontrolu. Pomocou presného textového zadania a voliteľných referencií vytvárajte produktové vizuály, podklady pre kampane, ikony alebo cielenú úpravu existujúceho obrázka.
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 Quality je model spoločnosti SpaceXAI na tvorbu a úpravu obrázkov s dôrazom na realistické detaily, lepšie vykresľovanie textu a dôsledné dodržiavanie kreatívneho zadania. Prijíma text a voliteľné obrazové referencie a vracia obrázok. Využijete ho na vizualizáciu produktov, kreatívu pre kampane, podklady pre sociálne siete, ilustrácie a ikony v štýle používateľského rozhrania. Rozsah štýlov zahŕňa fotografické a filmové zobrazenie aj grafickú tvorbu.
Pri produktovej scéne najprv opíšte predmet, rozmiestnenie, materiál, osvetlenie a pohľad kamery a až potom pridajte dekoratívny štýl. Ak musí zostať rozpoznateľný tvar produktu alebo jeho nápisy, priložte referenciu. Užitočné zadanie môže umiestniť malú fľašu s etiketou na kamenný povrch, určiť farebnú paletu a ponechať miesto na nadpis. Pri ikone alebo grafike určte tvar, kontrast a zamýšľanú vizuálnu mierku. Výsledkom je vykreslený obrázok, nie fungujúce rozhranie ani upraviteľný súbor rozloženia.
Pri úprave sa k pokynu pridáva zdrojový obrázok. Uložené obrazové referencie musia byť v postupe výrobcu úplne nahrané a vo formáte PNG, JPEG alebo WebP. Pomenujte zmenu aj to, čo má zostať zachované: nové pozadie, iný materiál, cielenú zmenu štýlu alebo opravený popis. Keď do kompozície vstupuje viac referencií, opíšte ich úlohy samostatne, napríklad produkt z jedného obrázka a vzhľad značky z druhého. Ponechajte dostupnú pôvodnú produktovú referenciu, aby neskoršie úpravy nestratili identitu vytvorenú v prvom podklade.
Praktická postupnosť môže začať vizualizáciou produktu a potom ten istý vizuál umiestniť do iného prostredia alebo tlačovej kompozície. Vybraný výstup použite ako vstup ďalšej úpravy a nový pokyn zamerajte na príslušnú premenu. Pri variante pre kampaň zachovajte vydarený hlavný motív a hierarchiu a zmeňte prostredie alebo sprievodný text. Obrázok tak rozvíjate v jasných krokoch namiesto očakávania, že si neskorší pokyn zapamätá starší podklad, ktorý nebol priložený.
Typografia a jemné textúry patria k tvorivému zameraniu modelu Quality. Pre menu, etiketu alebo reklamu uveďte presné slová, číslice a ich umiestnenie a opíšte, ako má text zapadnúť do materiálu alebo kompozície. Skontrolujte pravopis, poradie čítania a drobné písmo pri skutočnej veľkosti zobrazenia. Realistická textúra môže podporiť vizuálnu prezentáciu produktu, no faktické vlastnosti produktu musia naďalej vychádzať zo schváleného zadania a referencií.
Obrazový postup výrobcu podporuje rozlíšenie 1K a 2K a kompozície na šírku, štvorcové aj na výšku. Ak pomer strán neurčíte, vyberie sa automaticky. Tvar obrázka voľte podľa objektu a umiestnenia textu; rozlíšenie nenahrádza rozloženie. Viac alternatív možno vyžiadať spoločným nastavením počtu generovaných obrázkov v rozsahu od jedného do desiatich, pričom predvolená hodnota je jeden. Porovnávanie alternatív pomáha pri výbere kompozície; nedokazuje, že každý výsledok obsahuje všetky požadované detaily.
Obrázky sa bežne vracajú prostredníctvom dočasných hostovaných umiestnení. Keď obrázok potrebujete vložiť priamo do výstupu aplikácie, je k dispozícii doručenie vo formáte base64. Uchovajte skutočný vybraný podklad a nespoliehajte sa na dočasné umiestnenie ako na jedinú kópiu projektu. Integrácia obrazových súborov výrobcu tiež ukazuje použitie uložených identifikátorov obrázkov ako referencií a ukladanie vygenerovaných obrazových súborov na neskoršie použitie. Tieto možnosti doručenia a uloženia sú oddelené od vizuálneho zadania, ktoré určuje obsah obrázka.
Model s názvom Image Quality sa líši od parametra kvality low, medium a auto v Grok Imagine Image 2.0. Tieto neskoršie ovládacie prvky kvality a rozšírené možnosti referencií či pomerov strán nemožno považovať za nastavenia tohto profilu. Vyžiadanie viacerých alternatív v jednom obrazovom volaní sa líši aj od Batch API výrobcu, ktoré stránka konkrétneho modelu Quality neuvádza ako podporované. Pri príprave opakovateľného postupu uchovajte spolu výber modelu, zadanie, referencie a vybraný výstup.
Pri dokončenom obrázku porovnajte požadovanú scénu, produktové detaily, typografiu a zachované prvky so zadaním a potom upravte konkrétnu časť, ktorá nesplnila cieľ. Vygenerovaný statický obrázok sa môže stať referenciou pre samostatnú videoúlohu, no vlastným výstupom obrazového modelu zostáva obrázok. Uchovajte vydarenú verziu aj referenčné materiály, aby neskoršia úprava kampane alebo zmena umiestnenia mohla rozvíjať ten istý kreatívny smer.
Ailoot Ultra · Obrázky POST /v1/images/generations x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-qualityÚvod
Grok Imagine Image Quality vytvára a upravuje obrázky s dôrazom na realizmus, vykresľovanie textu a tvorivú kontrolu. Pomocou presného textového zadania a voliteľných referencií vytvárajte produktové vizuály, podklady pre kampane, ikony alebo cielenú úpravu existujúceho obrázka.
- 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é |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity x-ai/grok-imagine-image-quality | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1K, 2K | Predvolené— |
Poleaspect_ratio | Typstring | 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é— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 1 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 3 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_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.1 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
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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Čítanie ďalšieho obsahu
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 |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Aliasy
Aliasy modelov
Ailoot Ultra x-ai/grok-imagine-image-quality
Aliasy ciest metód
/v1/images
Súvisiace ID na volanie
FAQ · SpaceXAI: Grok Imagine Image Quality
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:model,prompt,resolution,aspect_ratio,n,input_references,provider- Aké limity platia?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:n.minimum:1;n.maximum:1