SpaceXAI: Grok Imagine Video 1.5
Grok Imagine Video 1.5 skaber korte videoer med synkroniseret lyd ud fra tekst, et startbillede eller visuelle referencer. Den tilbyder direkte tekst-/billedgenerering i 1080p, op til 14 referencebilleder og tre forudindstillede stemmer samt kontroller for første, sidste og mellemliggende billeder til at styre figur- og produktscener.
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 Video 1.5 er den fulde genereringsudgave af Grok Imagine-videofamilien. Producenten lægger vægt på bevægelse, fysisk kontinuitet og lydeffekter, atmosfære og tale genereret sammen med billedet. Tekst-til-video og billede-til-video renderer direkte i 1080p, mens referencestyret generering giver større kontrol over, hvem eller hvad der optræder i en scene. Det nyttige resultat er en kort video med tilhørende lyd, for eksempel en produktpræsentation, en samtale mellem figurer eller en præcist iscenesat overgang mellem visuelle ankre.
Til tekst-til-video skal du beskrive indstillingens motiv, omgivelser, handling, kamerabevægelse, lys og lyd. Producenten forklarer, at 1.5 internt genererer et startbillede og derefter animerer det; det mellemliggende stillbillede returneres ikke. Til billede-til-video bliver et leveret billede det første billede, og prompten beskriver, hvad der sker derefter. Forbered billedet med den ønskede indramning og de synlige detaljer allerede til stede. Det resulterende billede-til-video-klip følger kildebilledets format, så en lodret leverance kræver en passende startbeskæring.
Reference-til-video giver billeder en anden rolle: de styrer personer, objekter, tøj eller steder uden automatisk at fastlægge åbningsbilledet. Den dokumenterede grænse er op til 14 referencebilleder med output på op til 15 sekunder ved 720p. Giv hvert billede en tydelig rolle i scenen, og identificer det ved dets position i referencelisten. I producentens promptsyntaks er den første reference <IMAGE_0>, efterfulgt af <IMAGE_1> og så videre. Når et åbningsbillede også er fastlagt, tager det det første indeks, og de særskilte referencer starter med det næste. Denne rækkefølge er vigtig, når en brief skelner mellem en person, et produkt og et miljø.
En oprindelig referencebrief kan placere en figur ved siden af stolen leveret i ét billede inde i rummet leveret i et andet med en langsom bevægelse mod en detalje i stolens materiale. Hold motiv og hovedprodukt lette at skelne i referencerne. Producenten anbefaler at give hver reference én rolle og en fast plads, holde persongalleriet lille og rekvisitter statiske ved mange input. Gennemgå, om det tilsigtede objekts form og markeringer videreføres til scenen, og om kameraet viser den detalje, briefen anmoder om.
Reference-til-video kan også tildele op til tre forudindstillede stemmer. Identificer den ønskede taler og dens stemme særskilt i prompten med de dokumenterede positionsbestemte stemmereferencer, og lever den præcise dialog, taleren skal sige. Modellen understøtter læbesynkroniseret tale. Til en kort udveksling skal replikkerne give plads til svaret, og både talertildeling og mundbevægelse skal undersøges i det resulterende klip. En stemmereference vælger taleridentiteten; kamera- og sceneinstruktionerne skal stadig beskrive, hvordan figurerne vises.
Kontrollerne for første og sidste billede forankrer indstillingens endepunkter, og op til fire nøglebilleder kan fastlægge billeder på mellemliggende tidspunkter. Producentens nøglebilledvejledning placerer disse tider strengt inde i klippet på et gitter med en tredjedel sekund mellem punkterne; to ankre, der ender i samme tidsfelt, afvises. Forbered ankre, der hører til samme scene, og beskriv bevægelsen imellem dem. Til en produktafsløring kan begyndelsen vise den lukkede udstilling og det sidste billede den afslørede genstand. Til en løkke kan samme billede bruges som første og sidste billede. Lyt og se gennem overgangen frem for kun at vurdere de fastlagte billeder.
Almindelig tekst-til-video og billede-til-video understøtter klip på 1–15 sekunder og output ved 480p, 720p eller direkte 1080p. Reference-til-video er begrænset til 720p. Tekstbaseret indramning omfatter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 og 5:2. Vælg varighed og form efter handling og destination. Producenten genererer lyd som standard og dokumenterer en mulighed for lydløs video. En brief kan angive replik, nære effekter og fjern atmosfære, så lyden bidrager til den samme scene frem for at blive en uspecificeret baggrund.
Den dokumenterede genereringsarbejdsgang er asynkron: den returnerer en anmodningsidentifikator og derefter et færdigt resultat med klipplacering og varighed. Eksempelresultatet peger på en MP4-video, og den hostede outputplacering er midlertidig. Gem det færdige klip og inputbriefen, når du forbereder en redigering. Kontrollér, at objekterne forbliver til stede, og gennemgå kontinuitet, bevægelse, indramning og lyd i forhold til den tilsigtede indstilling. En mellemliggende behandlingspost er nyttig til at spore arbejdet, mens den afspillelige video er artefaktet, der skal gennemgås.
Versionsforskelle påvirker planen. Lite håndterer ligetil tekst eller animation fra ét billede med 1080p-muligheden opskaleret fra 720p. Fuld 1.5 tilføjer referencebilleder, forudindstillede stemmer og fastlagte billeder. Den klassiske Grok Imagine Video-udgave tilbyder redigering og forlængelse af eksisterende videoer. Udgivelsens særskilte hastighedstal for Video 1.5 Fast vedrører den navngivne variant og definerer derfor ikke en fast færdiggørelsestid for denne model. Til en længere sekvens skal du iscenesætte sammenhængende korte indstillinger og gennemgå figur-, produkt- og lydkontinuitet, når klippene sættes 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 skaber korte videoer med synkroniseret lyd ud fra tekst, et startbillede eller visuelle referencer. Den tilbyder direkte tekst-/billedgenerering i 1080p, op til 14 referencebilleder og tre forudindstillede stemmer samt kontroller for første, sidste og mellemliggende billeder til at styre figur- og produktscener.
- Accepterede input
- Tekst · Billeder
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Video POST /v1/videos
- Inputtyper
text,image- Outputtyper
video- Outputformat
- oprindelige MP4-bytes; ingen normalisering/transkodning
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser x-ai/grok-imagine-video-1.5 | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser | Standard— |
Feltduration | Typeinteger | KravPåkrævet | Værdier og grænser 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480p, 720p, 1080p | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Standard— |
Feltgenerate_audio | Typeboolean | KravValgfrit | Værdier og grænser false | Standard— |
Feltframe_images | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 Inputindhold: Array af billedobjekter. Hvert objekt har type=image_url, image_url med url samt frame_type. Brug en HTTPS URL til et billede, og sæt frame_type til first_frame. Hver billedrolle må højst forekomme én gang. Præcise nøgler: type, image_url, frame_type Betingelser: Disse nøgler beskriver hvert billedobjekt; image_url indeholder kun url. Udelad frame_images ved en forespørgsel med kun tekst. | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser | Standard— |
Feltcallback_url | Typestring | KravValgfrit | Værdier og grænser Mønster: ^https:// | Standard— |
Feltsession_id | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Felttrace | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Feltuser | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Kombinationer af inputmaterialer
Tekst til video · En skriftlig prompt. · Påkrævet: model, prompt, duration
Angiv prompten som tekst og varigheden i hele sekunder. Vælg en understøttet opløsning og om nødvendigt et billedformat.
model: Type: string · x-ai/grok-imagine-video-1.5
prompt: Type: string · Maksimalt antal UTF-8-bytes: 10.000 · Mindst ét tegn, der ikke er et blanktegn, kræves: Ja
Billede til video · En skriftlig prompt og et billede til første frame. · Påkrævet: model, prompt, duration, frame_images
frame_images er et array. Hvert billedobjekt har type, image_url og frame_type; image_url indeholder url. Sæt type til image_url. Brug first_frame. Hver billedrolle må højst forekomme én gang. Angiv en offentlig HTTPS URL til hvert billede. Vælg en understøttet opløsning og om nødvendigt et billedformat.
Præcise nøgler: type, image_url, frame_type
model: Type: string · x-ai/grok-imagine-video-1.5
prompt: Type: string · Maksimalt antal UTF-8-bytes: 10.000 · Mindst ét tegn, der ikke er et blanktegn, kræves: Ja
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt, duration |
Parametermaterial_types | Kontrakttext, image |
Parameteradditional_properties | Kontraktfalse |
Parameteroptional_controls | Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Livscyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Afregningsbetingelser | Beløb |
|---|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Afregningsbetingelser— | 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. billede | AfregningsbetingelserDer er ikke angivet nogen yderligere betingelse i denne prisnøgle. | Beløb Input · Inputbillede · Estimat kun til sammenligning $0.02 pr. billede |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 1080p | Beløb Output · Videopris · Estimat kun til sammenligning $0.5 pr. videosekund |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 480p | Beløb Output · Videopris · Estimat kun til sammenligning $0.16 pr. videosekund |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 720p | Beløb Output · Videopris · Estimat kun til sammenligning $0.28 pr. videosekund |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Afregningsbetingelser— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.16 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 →
Detaljer om referencetariffen
Referenceplaner på modelniveau ændrer ikke metodevalg, prisoverslag eller opkrævninger. Ved den aktive afregning anvendes taksterne for den valgte Ailoot-metode.
Prisreferencer for videokonfigurationer
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Afregningsbetingelser | Beløb |
|---|---|---|
| KonfigurationInputbillede | AfregningsbetingelserDer er ikke angivet nogen yderligere betingelse i denne prisnøgle. | Beløb Input · Inputbillede $0.02 pr. billede Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
| KonfigurationVideopris | Afregningsbetingelserresolution: 480p | Beløb Output · Videopris $0.16 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
| KonfigurationVideopris | Afregningsbetingelserresolution: 720p | Beløb Output · Videopris $0.28 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
| KonfigurationVideopris | Afregningsbetingelserresolution: 1080p | Beløb Output · Videopris $0.5 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
Eksempelanmodninger
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
Hent og gem resultater
Ailoot Ultra · Video
signerede indholds-URL’er, du ejer
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontrollér opgavestatus
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
Læsning af andet indhold
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 færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hvert faktisk output, du ejer, og dets returnerede, målte metadata.
Hvis det oprindelige svar skal kontrolleres
503 result_pending_check + originalid + X-Should-Retry:false; gentag aldrig originalen
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltindex | Typeinteger | BetydningDenne videos position i outputlisten, talt fra nul. |
Feltcontent_url | Typestring | BetydningSigneret HTTPS URL til download af denne færdige video. |
Feltsha256 | Typestring | null | BetydningSHA-256-hash af de oprindelige videobytes; null, hvis den ikke er tilgængelig. |
Feltsize_bytes | Typeinteger | null | BetydningDen oprindelige videofils størrelse i bytes; null, hvis den ikke er tilgængelig. |
Feltduration_ms | Typeinteger | null | BetydningMålt videovarighed i millisekunder; null, hvis den ikke er tilgængelig. |
Feltwidth | Typeinteger | null | BetydningVideoens bredde i pixels; null, hvis den ikke er tilgængelig. |
Feltheight | Typeinteger | null | BetydningVideoens højde i pixels; null, hvis den ikke er tilgængelig. |
Feltvideo_codec | Typestring | null | BetydningIdentifikator for videocodec; null, hvis den ikke er registreret. |
Felthas_audio | Typeboolean | null | BetydningOm videoen indeholder et lydspor; null, hvis det ikke er målt. |
Feltaudio_codec | Typestring | null | BetydningIdentifikator for lydcodec; null, når ingen identifikator er registreret. |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar404 · not_found_error | BetingelseVideoadgang er utilgængelig, eller dette video-ID blev ikke fundet. | Næste trinKontrollér videoadgang. For en eksisterende video skal du bruge dens oprindelige offentlige ID og samme API-nøgle. |
Svar401 · authentication_error | BetingelseAPI-nøglen stemmer ikke overens med den autentificerede konto. | Næste trinKontrollér din API-nøgle og kontoadgang, før du indsender. |
Svar400 · invalid_request_error | BetingelseForespørgslen kunne ikke læses, eller downloadindekset er ugyldigt. | Næste trinRet forespørgselsindholdet. Ved download skal du vælge et outputindeks, der er returneret af den oprindelige opgave. |
Svar422 · price_unavailable | BetingelseDen valgte videokonfiguration kan ikke prissættes. | Næste trinVælg en understøttet videokonfiguration, og udfyld dens påkrævede indstillinger, før du sender en rettet forespørgsel. |
Svar422 · invalid_request_error | BetingelseEt videoinput eller den oprindelige fortsættelsesopgave er ugyldigt. | Næste trinBrug gyldigt HTTPS-input. Ved fortsættelse skal du bruge din færdige originals offentlige video-ID med samme API-nøgle. |
Svar402 · billing_error | BetingelseDen tilgængelige saldo eller grænserne tillader ikke en reservation. | Næste trinKontrollér din tilgængelige saldo og dine grænser, før du sender en ny forespørgsel. |
Svar503 · server_error | BetingelseVideokontrol, lager eller tjenesteadgang er midlertidigt utilgængelig. | Næste trinVent, indtil tjenesten er tilgængelig. Hvis du allerede har et video-ID, skal du kontrollere den oprindelige opgave i stedet for at oprette en ny generering. |
Svar503 · result_pending_check | BetingelseDet oprindelige videoresultat og opkrævningen skal kontrolleres. | Næste trinBehold det returnerede video-ID, og kontrollér denne opgave. Send ikke en erstatningsforespørgsel om generering, mens den kontrolleres. |
Svar503 · owned_result_unavailable | BetingelseDownload af den eksisterende video er midlertidigt utilgængelig. | Næste trinKontrollér samme videoopgave senere, og download dens eksisterende output. En ny generering opretter en separat operation. |
Svar409 · video_not_ready | BetingelseVideoindholdet er ikke blevet offentliggjort. | Næste trinKontrollér den oprindelige opgaves status. Download, når den melder completed; hvis den melder failed, skal du følge dens meddelelse om kontrol af opkrævningen. |
Aliaser
Modelaliaser
Ailoot Ultra x-ai/grok-imagine-video-1.5
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · SpaceXAI: Grok Imagine Video 1.5
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·x-ai/grok-imagine-video-1.5:text,image→video- Hvilke felter bruger anmodningen?
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 grænser gælder?
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