SpaceXAI: Grok Imagine Video 1.5
Grok Imagine Video 1.5 lager korte videoer med synkronisert lyd fra tekst, et startbilde eller visuelle referanser. Den tilbyr direkte 1080p-generering fra tekst og bilde, opptil 14 referansebilder og tre forhåndsdefinerte stemmer, samt kontroller for første-, siste- og mellombilder til karakter- og produktscener.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Grok Imagine Video 1.5 er den fullstendige genereringsutgaven i Grok Imagine-videofamilien. Produsenten fremhever bevegelse, fysisk kontinuitet og lydeffekter, atmosfære og tale generert sammen med bildet. Tekst-til-video og bilde-til-video rendres direkte i 1080p, mens referansestyrt generering gir mer kontroll over hvem eller hva som vises i en scene. Det nyttige resultatet er en kort video med lyd, som en produktpresentasjon, en karakterutveksling eller en presist iscenesatt overgang mellom visuelle holdepunkter.
Til tekst-til-video beskriver du innstillingens motiv, omgivelser, handling, kamerabevegelse, belysning og lyd. Produsenten forklarer at 1.5 genererer et startbilde internt og deretter animerer det; mellomstillbildet returneres ikke. Til bilde-til-video blir et oppgitt bilde førstebildet, og prompten beskriver hva som skjer videre. Forbered bildet med ønsket utsnitt og synlige detaljer allerede til stede. Det resulterende bilde-til-video-klippet følger kildebildets sideforhold, så stående levering trenger en passende startbeskjæring.
Referanse-til-video gir bildene en annen rolle: de veileder personer, objekter, klær eller steder uten automatisk å fastsette åpningsbildet. Dokumentert grense er opptil 14 referansebilder, med utdata på opptil 15 sekunder ved 720p. Gi hvert bilde en tydelig rolle i scenen og identifiser det med plasseringen i referanselisten. I produsentens promptsyntaks er første referanse <IMAGE_0>, fulgt av <IMAGE_1> og så videre. Når et åpningsbilde også er fastlagt, tar det første indeks, og de separate referansene begynner med den neste. Rekkefølgen betyr noe når en beskrivelse skiller en person, et produkt og omgivelser.
En opprinnelig referansebeskrivelse kan plassere en karakter ved stolen fra ett bilde, inne i rommet fra et annet, med en langsom bevegelse mot stolens materialdetalj. Hold motivet og det sentrale produktet lette å skille i referansene. Produsenten anbefaler å gi hver referanse én rolle og en fast plass, holde persongalleriet lite og rekvisitter statiske når mange inndata brukes. Gjennomgå om det tiltenkte objektets form og merking videreføres i scenen, og om kameraet avdekker detaljen beskrivelsen ba om.
Referanse-til-video kan også tildele opptil tre forhåndsdefinerte stemmer. Identifiser tiltenkt taler og stemme separat i prompten med de dokumenterte posisjonsbaserte stemmereferansene, og oppgi nøyaktig dialog taleren skal si. Modellen støtter leppesynkronisert tale. Til en kort samtale skriver du replikker som gir rom for svar, og undersøker både talertildeling og munnbevegelse i klippet. En stemmereferanse velger taleidentiteten; kamera- og sceneinstruksjonene må fortsatt beskrive hvordan karakterene vises.
Kontrollene for første- og sistebilde forankrer innstillingens endepunkter, og opptil fire nøkkelbilder kan fastlegge bilder på mellomliggende tidspunkter. Produsentens nøkkelbildeveiledning plasserer tidspunktene strengt inne i klippet på et tidsrutenett med trinn på et tredels sekund; to holdepunkter som treffer samme tidsluke, avvises. Forbered holdepunkter som tilhører samme scene og beskriv bevegelsen mellom dem. Ved avduking av et produkt kan åpningen vise den lukkede utstillingen og sluttbildet den avdekkede gjenstanden. Til en løkke kan samme bilde fungere som første- og sistebilde. Lytt og se gjennom overgangen i stedet for å vurdere bare de fastlagte bildene.
Vanlig tekst- og bilde-til-video støtter klipp på 1–15 sekunder og utdata på 480p, 720p eller direkte 1080p. Referanse-til-video er begrenset til 720p. Tekstbasert utsnitt omfatter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 og 5:2. Velg varighet og form etter handling og brukssted. Produsenten genererer lyd som standard og dokumenterer et lydløst videoalternativ. En beskrivelse kan spesifisere replikk, nære effekter og fjern atmosfære slik at lyd bidrar til samme scene i stedet for å bli en uspesifisert bakgrunn.
Den dokumenterte genereringsflyten er asynkron: den returnerer en forespørselsidentifikator og deretter et fullført resultat med klipplassering og varighet. Eksempelresultatet peker til en MP4-video, og den driftede utdataplasseringen er midlertidig. Bevar det ferdige klippet og inndatabeskrivelsen når du forbereder en redigering. Kontroller kontinuitet, at objektene forblir til stede, bevegelse, utsnitt og lyd opp mot ønsket innstilling. En mellomliggende behandlingspost er nyttig for sporing, mens den avspillbare videoen er resultatet som skal gjennomgås.
Versjonsforskjeller påvirker planen. Lite håndterer enkel tekst eller animasjon av ett bilde, med et 1080p-alternativ oppskalert fra 720p. Full 1.5 legger til referansebilder, forhåndsdefinerte stemmer og fastlagte bilder. Den klassiske Grok Imagine Video-utgaven tilbyr redigering og forlengelse av eksisterende videoer. Utgivelsens separate hastighetstall for Video 1.5 Fast gjelder den navngitte varianten og definerer derfor ikke en fast fullføringstid for denne modellen. Til en lengre sekvens iscenesetter du sammenhengende korte innstillinger og gjennomgår karakter-, produkt- og lydkontinuitet når klippene ordnes sammen.
Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video-1.5
x-ai/grok-imagine-video-1.5Start
Grok Imagine Video 1.5 lager korte videoer med synkronisert lyd fra tekst, et startbilde eller visuelle referanser. Den tilbyr direkte 1080p-generering fra tekst og bilde, opptil 14 referansebilder og tre forhåndsdefinerte stemmer, samt kontroller for første-, siste- og mellombilder til karakter- og produktscener.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Video POST /v1/videos
- Inndatatyper
text,image- Utdatatyper
video- Utdataformat
- opprinnelige MP4-bytes; ingen normalisering/transkoding
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser x-ai/grok-imagine-video-1.5 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser | Standard— |
Feltduration | Typeinteger | KravPåkrevd | Verdier & grenser 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 480p, 720p, 1080p | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Standard— |
Feltgenerate_audio | Typeboolean | KravValgfritt | Verdier & grenser false | Standard— |
Feltframe_images | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 1 Inngående innhold: Matrise med bildeobjekter. Hvert objekt har type=image_url, image_url som inneholder url, og frame_type. Bruk en HTTPS-basert URL til bildet, og sett frame_type til first_frame. Hver bilderolle forekommer høyst én gang. Nøyaktige nøkler: type, image_url, frame_type Vilkår: Disse nøklene beskriver hvert bildeobjekt; image_url inneholder bare url. Utelat frame_images ved en forespørsel som bare inneholder tekst. | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser | Standard— |
Feltcallback_url | Typestring | KravValgfritt | Verdier & grenser Mønster: ^https:// | Standard— |
Feltsession_id | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Felttrace | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Feltuser | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Kombinasjoner av inngående materialer
Tekst til video · En skriftlig ledetekst. · Påkrevd: model, prompt, duration
Oppgi prompt som tekst og duration som hele sekunder. Velg en støttet oppløsning og ved behov et sideforhold.
model: Type: string · x-ai/grok-imagine-video-1.5
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Bilde til video · En skriftlig ledetekst og et bilde for første enkeltbilde. · Påkrevd: model, prompt, duration, frame_images
frame_images er en matrise. Hvert bildeobjekt har type, image_url og frame_type; image_url inneholder url. Sett type til image_url. Bruk first_frame. Hver bilderolle forekommer høyst én gang. Oppgi en offentlig tilgjengelig HTTPS-basert URL til bildet for hvert enkeltbilde. Velg en støttet oppløsning og ved behov et sideforhold.
Nøyaktige nøkler: type, image_url, frame_type
model: Type: string · x-ai/grok-imagine-video-1.5
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt, duration |
Parametermaterial_types | Avtaletext, image |
Parameteradditional_properties | Avtalefalse |
Parameteroptional_controls | Avtaleresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Livssyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonInndatabilde | Prisplan— | Forventet mengde— | Faktureringsenhetper bilde | FaktureringsvilkårIngen ytterligere betingelse er angitt i denne prisnøkkelen. | Kostnad Inndata · Inndatabilde · Estimat kun for sammenligning $0.02 per bilde |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 1080p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.5 per videosekund |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.16 per videosekund |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.28 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.16 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Detaljer om referansetariffen
Referanseprisplaner på modellnivå endrer ikke metodevalg, prisoverslag eller kostnader. Aktive kostnader bruker satsene til den valgte Ailoot-metoden.
Prisreferanser for videokonfigurasjoner
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Faktureringsvilkår | Kostnad |
|---|---|---|
| KonfigurasjonInndatabilde | FaktureringsvilkårIngen ytterligere betingelse er angitt i denne prisnøkkelen. | Kostnad Inndata · Inndatabilde $0.02 per bilde Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris $0.16 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris $0.28 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 1080p | Kostnad Utdata · Videopris $0.5 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
Eksempelforespørsler
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video-1.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-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 json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Motta og lagre resultater
Ailoot Ultra · Video
Signerte innholdsadresser for ressurser du eier
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontroller jobbstatus
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Andre innholdslesinger
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold alle faktiske utdata du eier, og de returnerte målte metadataene.
Hvis det opprinnelige svaret må kontrolleres
503 result_pending_check + opprinnelig id + X-Should-Retry:false; gjenta aldri den opprinnelige sendingen
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltindex | Typeinteger | BetydningNullbasert posisjon for denne videoen i utdatalisten. |
Feltcontent_url | Typestring | BetydningSignert HTTPS-basert URL for nedlasting av denne ferdigstilte videoen. |
Feltsha256 | Typestring | null | BetydningSHA-256-kontrollsum for den opprinnelige videoens byte; null hvis utilgjengelig. |
Feltsize_bytes | Typeinteger | null | BetydningStørrelsen på den opprinnelige videofilen i byte; null hvis utilgjengelig. |
Feltduration_ms | Typeinteger | null | BetydningMålt videovarighet i millisekunder; null hvis utilgjengelig. |
Feltwidth | Typeinteger | null | BetydningVideobredde i piksler; null hvis utilgjengelig. |
Feltheight | Typeinteger | null | BetydningVideohøyde i piksler; null hvis utilgjengelig. |
Feltvideo_codec | Typestring | null | BetydningIdentifikator for videokodeken; null hvis ikke registrert. |
Felthas_audio | Typeboolean | null | BetydningOm videoen inneholder et lydspor; null hvis ikke målt. |
Feltaudio_codec | Typestring | null | BetydningIdentifikator for lydkodeken; null når ingen identifikator er registrert. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar404 · not_found_error | VilkårVideotilgang er utilgjengelig, eller denne video-ID-en ble ikke funnet. | Neste trinnKontroller videotilgangen. For en eksisterende video bruker du den opprinnelige offentlige ID-en og samme API-nøkkel. |
Svar401 · authentication_error | VilkårAPI-nøkkelen samsvarer ikke med den autentiserte kontoen. | Neste trinnKontroller API-nøkkelen din og kontotilgangen før innsending. |
Svar400 · invalid_request_error | VilkårForespørselen kunne ikke leses, eller nedlastingsindeksen er ugyldig. | Neste trinnKorriger forespørselskroppen. Ved nedlasting velger du en utdataindeks som ble returnert av den opprinnelige oppgaven. |
Svar422 · price_unavailable | VilkårDen valgte videokonfigurasjonen kan ikke prises. | Neste trinnVelg en støttet videokonfigurasjon og fyll ut de påkrevde alternativene før du sender en korrigert forespørsel. |
Svar422 · invalid_request_error | VilkårVideoinndata eller den opprinnelige fortsettelsesoppgaven er ugyldig. | Neste trinnBruk gyldige HTTPS-inndata. Ved fortsettelse bruker du den ferdigstilte originalens offentlige video-ID med samme API-nøkkel. |
Svar402 · billing_error | VilkårDen tilgjengelige saldoen eller grensene tillater ikke en reservasjon. | Neste trinnKontroller tilgjengelig saldo og grenser før du sender en ny forespørsel. |
Svar503 · server_error | VilkårVideokontroll, lagring eller tjenestetilgang er midlertidig utilgjengelig. | Neste trinnVent til tjenesten er tilgjengelig. Hvis du allerede har en video-ID, kontroller den opprinnelige oppgaven fremfor å opprette en ny generering. |
Svar503 · result_pending_check | VilkårDet opprinnelige videoresultatet og belastningen må kontrolleres. | Neste trinnBehold den returnerte video-ID-en og kontroller den oppgaven. Ikke send en erstatningsforespørsel om generering mens den kontrolleres. |
Svar503 · owned_result_unavailable | VilkårNedlasting av den eksisterende videoen er midlertidig utilgjengelig. | Neste trinnKontroller den samme videooppgaven senere og last ned de eksisterende utdataene. En ny generering oppretter en separat operasjon. |
Svar409 · video_not_ready | VilkårVideoinnholdet er ikke publisert. | Neste trinnKontroller den opprinnelige oppgavestatusen. Last ned etter at den rapporterer completed; hvis den rapporterer failed, følg varselet om kontroll av belastningen. |
Aliaser
Modellaliaser
Ailoot Ultra x-ai/grok-imagine-video-1.5
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · SpaceXAI: Grok Imagine Video 1.5
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·x-ai/grok-imagine-video-1.5:text,image→video- Hvilke felt bruker forespørselen?
POST /v1/videos·x-ai/grok-imagine-video-1.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Hvilke grenser gjelder?
POST /v1/videos·x-ai/grok-imagine-video-1.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1