SpaceXAI: Grok Imagine Video
Grok Imagine Video genererer korte klipp fra tekst, et startbilde eller opptil sju visuelle referanser. Den klassiske utgaven redigerer også eksisterende MP4-klipp og legger til 2–10 sekunder videreføring. Generering når 720p med lyd; redigering og forlengelse bevarer kildens utsnitt innenfor egne grenser.
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 er den klassiske utgaven i Grok Imagine-videofamilien. Produsentens gjeldende dokumentasjon dekker generering av et nytt klipp fra en prompt, animasjon av et startbilde, bruk av visuelle referanser og endring eller videreføring av en eksisterende video. Arbeidsflytene gir forskjellige resultater: en ny scene, en redigert versjon av oppgitte opptak eller én video med originalopptak fulgt av nytt innhold. Velg arbeidsflyt ut fra materialet som allerede finnes og delen av innstillingen som trenger endring.
Til en ny tekst-til-video-innstilling beskriver du motiv, miljø, synlig handling, kamera og lyd. Standardgenerering støtter klipp på 1–15 sekunder med 480p- eller 720p-utdata og generert lyd. Kvadratiske, liggende, stående og bredere sideforhold er dokumentert, inkludert 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 og 5:2. En opprinnelig beskrivelse kan be om en papirlykt som beveger seg forsiktig over en rolig gårdsplass mens kameraet følger sideveis. En nyttig gjennomgang kontrollerer om bevegelse, utsnitt og omgivelseslyd støtter denne ene innstillingen.
I bilde-til-video er det oppgitte stillbildet førstebildet. Forbered det med ønsket beskjæring, motiv og synlige detaljer, og beskriv deretter handlingen som følger. Utdataene følger bildets sideforhold. Et startstillbilde gir en eksakt åpningskomposisjon, mens referanse-til-video bruker bilder til å veilede personer, produkter eller miljø i en nykomponert scene. Å skille de to rollene hjelper med å unngå en utilsiktet åpning når målet er å plassere et kjent objekt i andre omgivelser.
Den klassiske modellen godtar opptil sju referansebilder per referansestyrt forespørsel. Modusen er begrenset til ti sekunder og 720p. Gi hver referanse en tydelig rolle og identifiser den med plasseringen i listen, fra <IMAGE_0>. Til en produktvignett kan én referanse identifisere objektet og en annen ønsket sted. Hold beskrivelsen fokusert på objektets plassering og innstillingens hovedhandling. Den klassiske referansemodusen bruker sin egen konfigurasjon; full 1.5 gir de ekstra kontrollene for valgt stemme og fastlagte bilder.
Videoredigering tar et eksisterende klipp og en prompt som beskriver endringen. Produsenten godtar MP4-kilder med støttede kodeker som H.264, H.265 eller AV1, opptil 8,7 sekunder lange. Det redigerte resultatet beholder kildens varighet og sideforhold og følger oppløsningen opp til et tak på 720p. Tilpassede kontroller for varighet, sideforhold og oppløsning gjelder ikke for denne redigeringsarbeidsflyten. Forbered en kilde som allerede har komposisjonen og timingen sluttbruken trenger, slik at prompten kan konsentrere seg om ønsket visuell endring.
En opprinnelig redigeringsbeskrivelse kan endre fargen på et skjerf og bevare personens ansikt, bevegelse, bakgrunn og kamera. Angi de bevarte elementene eksplisitt sammen med endringen. Produsenten beskriver å beholde resten av kilden så tett som mulig, noe som er et nyttig mål for gjennomgang fremfor en garanti for at hver piksel forblir identisk. Sammenlign resultatet gjennom hele klippet, særlig der objektet beveger seg, krysser et annet objekt eller blir delvis skjult. Sluttresultatet er det redigerte klippet, ikke bare et stillbilde som viser den nye fargen.
Videoforlengelse fortsetter fra siste bilde i en eksisterende MP4. Dokumentert kildelengde er 2–15 sekunder; den tilføyde delen er 2–10 sekunder, med seks sekunder som standard. Forlengelsesvarigheten gjelder bare den nye delen. En kilde på ti sekunder fulgt av fem sekunder videreføring gir en video på femten sekunder med begge deler. Resultatet bevarer kildens sideforhold og oppløsning innenfor et tak på 720p. Forbered kildens siste øyeblikk og beskriv hva som skal skje videre, som at motivet vender seg mot en gjenstand som nærmer seg mens kameraet fortsetter nåværende bevegelse.
Gjennomgå en forlengelse rundt grensen mellom kilde og nytt innhold. Kontroller motividentitet, bevegelsesretning, kameratempo, lys og lyd slik at videreføringen passer til foregående handling. Hvis et klipp slutter på et visuelt vanskelig punkt, gjør du grensen til en eksplisitt del av planen for neste innstilling. Sammensetting av lengre scener er en redigeringsbeslutning: modellens grenser for generering, referanser, redigering og forlengelse er separate, og det samlede resultatet av en forlengelse kan være lengre enn et vanlig nygenerert klipp.
Produsentens videoarbeidsflyt er asynkron. En forespørselsidentifikator sporer en jobb til et fullført resultat gir videoplassering og varighet; utdataplasseringer er midlertidige. Behold det avspillbare resultatet og kildematerialet når en produksjonsredigering forberedes. Full Grok Imagine Video 1.5 tilbyr direkte 1080p-generering og rikere visuell, stemme- og bildeforankring, mens Lite tjener enkelt arbeid med prompt eller startbilde. Den klassiske utgaven er fortsatt nyttig når startmaterialet allerede er en video som trenger en regissert endring eller videreføring.
Ailoot Ultra · Video POST /v1/videos x-ai/grok-imagine-video
x-ai/grok-imagine-videoStart
Grok Imagine Video genererer korte klipp fra tekst, et startbilde eller opptil sju visuelle referanser. Den klassiske utgaven redigerer også eksisterende MP4-klipp og legger til 2–10 sekunder videreføring. Generering når 720p med lyd; redigering og forlengelse bevarer kildens utsnitt innenfor egne grenser.
- 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 | 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 | 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— |
Feltsize | Typestring | KravValgfritt | Verdier & grenser 854x480, 1280x720, 480x854, 720x1280, 480x480, 720x720, 640x480, 960x720, 480x640, 720x960, 720x480, 1080x720, 480x720, 720x1080 Mønster: ^[1-9][0-9]*x[1-9][0-9]*$ | 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; legg til et sideforhold eller bruk en oppført størrelse.
model: Type: string · x-ai/grok-imagine-video
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. Bruk enkeltbilder eller bildereferanser i én forespørsel; ikke kombiner begge. Velg en støttet oppløsning; legg til et sideforhold eller bruk en oppført størrelse.
Nøyaktige nøkler: type, image_url, frame_type
model: Type: string · x-ai/grok-imagine-video
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Reference to video · En skriftlig ledetekst og støttede bildereferanser. · Påkrevd: model, prompt, duration, input_references
input_references er en matrise med objekter. Sett type til image_url, og bruk det tilsvarende feltet som inneholder url. Bruk offentlig tilgjengelige HTTPS-adresser. Utelat frame_images for å velge referansemodus. Ikke kombiner bildereferanser med enkeltbilder. Velg en støttet oppløsning; legg til et sideforhold eller bruk en oppført størrelse.
model: Type: string · x-ai/grok-imagine-video
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, size, 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.004 per bilde |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.1 per videosekund |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.14 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.1 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.004 per bilde Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris $0.1 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris $0.14 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","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
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · SpaceXAI: Grok Imagine Video
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·x-ai/grok-imagine-video:text,image→video- Hvilke felt bruker forespørselen?
POST /v1/videos·x-ai/grok-imagine-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Hvilke grenser gjelder?
POST /v1/videos·x-ai/grok-imagine-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1