xAI: Grok Imagine Image 2.0
Grok Imagine Image 2.0 skaber billeder ud fra skriftlige oplæg og redigerer eksisterende billeder med instruktioner i naturligt sprog. xAI dokumenterer indstillinger for kvalitet, opløsning og komposition, referencer fra flere billeder, stiloverførsel og trinvis forbedring.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Grok Imagine Image 2.0 er xAI’s model til billedgenerering og redigering. Den modtager en skriftlig beskrivelse eller en beskrivelse sammen med kildebilleder og returnerer et billedresultat. Producentens navngivne 2.0-profil omfatter at skabe en scene, ændre et eksisterende billede, kombinere motiver fra referencer og omforme den visuelle stil. Begynd med at vælge, om du har brug for en ny komposition eller en bestemt ændring af materiale, du allerede har.
Skab et billede ud fra et oplæg
Beskriv hovedmotivet, omgivelserne, kompositionen, lyset og den visuelle behandling. Angiv, hvad beskueren først skal lægge mærke til, og hvor billedet skal bruges. Til et produktkoncept kan et eksempeloplæg beskrive en skrivebordslampe i keramik på et lyst stenbord, blødt vindueslys, et nærbillede af materialet og fri plads til en separat overskrift. Til en illustration skal du angive figurerne, handlingen og det ønskede udtryk frem for at forvente, at ét stilord definerer hele scenen.
Producenten dokumenterer ét til ti outputbilleder fra en genereringsanmodning, med ét som standard. Flere resultater fra samme oplæg giver alternativer at vurdere; de garanterer ikke et identisk motiv i alle variationer. Kontrollér motivet, kompositionen og de vigtige detaljer, og behold den version, der bedst passer til oplægget. Gem oplægget sammen med den valgte variation, så senere redigeringer tager udgangspunkt i den ønskede komposition.
Komposition, opløsning og kvalitet
Genereringsvejledningen dokumenterer automatisk valg af billedformat eller et udtrykkeligt angivet forhold. De anførte valg omfatter 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 og 5:2. Vælg formen efter den planlagte placering: kvadratisk til et kompakt felt, stående til en lodret komposition eller liggende til en bred scene. Angiv det motiv, der er følsomt over for beskæring, og den plads, layoutet kræver, frem for kun at stole på billedformatet.
De dokumenterede indstillinger for genereringsopløsning er 1k og 2k, med 1k som standard. Kvalitet er en separat indstilling med valgene low, medium og auto. I xAI’s aktuelle vejledning er auto standard og bruger low til generering og medium til redigering; en udtrykkelig indstilling til low eller medium fastholder dette valg. Opløsning og kvalitet beskriver derfor forskellige indstillinger. Angiv de visuelle detaljer, der er vigtige, og efterse dem i det returnerede billede frem for at behandle nogen af indstillingerne som en garanti for præcis tekst, geometri eller bevarelse af motivet.
Redigering og overførsel af visuel stil
Vedlæg billedet, der skal ændres, og beskriv ændringen i forhold til det synlige indhold. En afgrænset redigering kan bede om at erstatte en mørk væg med en lys pudset overflade, mens møblernes placering, kameravinklen og den varme belysning bevares. Hvis målet er en stilistisk omformning, skal du angive den ønskede behandling: producenten demonstrerer fotografi, anime, oliemaleri, akvarel, popkunst og blyantstegning. Angiv, hvilke elementer der skal bevare deres udseende, og hvilke der må ændres med behandlingen.
Producentens redigeringsforløb accepterer en reference til et kildebillede, kodede billeddata eller en filidentifikator. Til gemte referencer skal du bruge fuldt uploadede PNG-, JPEG- eller WebP-billeder. Vejledningen dokumenterer også successive redigeringer: brug resultatet af én redigering som input til den næste. Det kan gøre en grundkomposition mere specifik gennem en ændring af møbler efterfulgt af en justering af lyset. Hold originalen og det valgte mellembillede knyttet til hvert oplæg, så en senere forbedring kan kontrolleres mod den ønskede komposition.
Kombinér flere referencer
Den aktuelle vejledning til flere billeder tillader op til fem kildebilleder i én redigering. Henvis til dem i den rækkefølge, de er vedlagt, og giv hvert billede en klar rolle, såsom motivet fra det første billede og omgivelserne fra det andet. Outputformatet følger som standard det første inputbillede, men kan tilsidesættes med et udtrykkeligt angivet forhold. Til et produkt-i-rum-koncept skal du beskrive produktets placering, størrelse og kontakt med rummets overflader og derefter bede om at bevare de detaljer, der identificerer det. Vurdér, hvordan kilderne er kombineret, frem for at antage, at hvert element er kopieret uden ændringer.
Modtag og gem billedet
Producenten returnerer som standard en midlertidig billedadresse og dokumenterer også output som kodet billede. Gem selve billedet hurtigt, når det skal bruges som et aktiv. Det valgfrie udskudte forløb adskiller kvitteringen for anmodningen fra færdiggørelsen: en anmodningsidentifikator efterfølges af status pending, done eller failed, og udskudte resultater bruger adresseformatet med en dokumenteret opbevaring på 24 timer. En indsendt anmodning eller status pending er ikke et færdigt billede. Gem det færdige billede sammen med oplægget og de valgte indstillinger til senere genbrug.
Et nyttigt slutprodukt er et billede, der passer til et defineret scene-, layout- eller redigeringsoplæg. Efterse hele kompositionen og dens små detaljer, især kildemotivet, objektgrænser, proportioner og tekst, der bærer betydning. Ved trinvist arbejde skal du ændre den instruktion, der knytter sig til det synlige problem, og bruge det valgte resultat som næste reference. Hold instruktionerne om ændring og bevarelse konkrete, så hvert resultat kan vurderes i forhold til et bestemt kreativt formål.
Ailoot Ultra · Billeder POST /v1/images/generations x-ai/grok-imagine-image-2.0
x-ai/grok-imagine-image-2.0Start
Grok Imagine Image 2.0 skaber billeder ud fra skriftlige oplæg og redigerer eksisterende billeder med instruktioner i naturligt sprog. xAI dokumenterer indstillinger for kvalitet, opløsning og komposition, referencer fra flere billeder, stiloverførsel og trinvis forbedring.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser x-ai/grok-imagine-image-2.0 | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 1K, 2K | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 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 | Standard— |
Feltquality | Typestring | KravValgfrit | Værdier og grænser low, medium | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 3 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| Konfigurationinputbillede | Takstplan— | Forventet mængde— | Afregningsenhedpr. inputbillede | Beløb Input · inputbillede · Estimat kun til sammenligning $0.02 pr. inputbillede |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.08 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
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
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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.
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra x-ai/grok-imagine-image-2.0
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · xAI: Grok Imagine Image 2.0
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:model,prompt,resolution,aspect_ratio,quality,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:n.minimum:1;n.maximum:1