SpaceXAI: Grok Imagine Video 1.5
Grok Imagine Video 1.5 skapar korta videor med synkroniserat ljud från text, en startbild eller visuella referenser. Den erbjuder direkt generering i 1080p från text/bild, upp till 14 referensbilder och tre förinställda röster samt kontroller för första, sista och mellanliggande bildrutor för att styra karaktärs- och produktscener.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Grok Imagine Video 1.5 är den fullständiga genereringsversionen i Grok Imagine-videofamiljen. Tillverkaren betonar rörelse, fysisk kontinuitet och ljudeffekter, atmosfär och tal som genereras med bilden. Text-till-video och bild-till-video renderas direkt i 1080p, medan referensstyrd generering ger större kontroll över vem eller vad som finns i en scen. Det användbara resultatet är en kort video med sitt ljud, till exempel en produktpresentation, ett samtal mellan karaktärer eller en exakt iscensatt övergång mellan visuella ankare.
Beskriv tagningens motiv, miljö, handling, kamerarörelse, ljussättning och ljud för text-till-video. Tillverkaren förklarar att 1.5 genererar en startbild internt och sedan animerar den; den mellanliggande stillbilden returneras inte. För bild-till-video blir en angiven bild den första bildrutan och prompten beskriver vad som händer sedan. Förbered bilden med önskat bildutsnitt och synliga detaljer redan på plats. Det resulterande bild-till-video-klippet följer källbildens bildförhållande, så en stående leverans behöver en lämplig startbeskärning.
Referens-till-video ger bilder en annan roll: de vägleder personer, objekt, kläder eller platser utan att automatiskt fixera öppningsbildrutan. Den dokumenterade gränsen är upp till 14 referensbilder, med utdata på upp till 15 sekunder i 720p. Ge varje bild en tydlig roll i scenen och identifiera den genom dess plats i referenslistan. I tillverkarens promptsyntax är den första referensen <IMAGE_0>, följd av <IMAGE_1> och så vidare. När en öppningsbild också är fixerad tar den första indexet och de separata referenserna börjar med nästa. Ordningen är viktig när ett uppdrag skiljer mellan en person, en produkt och en miljö.
Ett ursprungligt referensuppdrag kan placera en karaktär bredvid stolen från en bild, inne i rummet från en annan, med en långsam rörelse mot stolens materialdetalj. Håll motivet och huvudprodukten lätta att skilja åt i referenserna. Tillverkaren rekommenderar att ge varje referens en roll och en fast plats, hålla persongalleriet litet och rekvisitan stilla när många indata används. Granska om det avsedda objektets form och märkningar följer med till scenen och om kameran visar detaljen som begärts i uppdraget.
Referens-till-video kan också tilldela upp till tre förinställda röster. Identifiera avsedd talare och dess röst separat i prompten med de dokumenterade positionsbaserade röstreferenserna och ange den exakta dialogen talaren ska säga. Modellen stöder läppsynkroniserat tal. Skriv repliker som lämnar utrymme för svaret i ett kort samtal och granska både talartilldelning och munrörelse i det resulterande klippet. En röstreferens väljer talaridentiteten; kamera- och scenanvisningar behöver fortfarande beskriva hur karaktärerna visas.
Kontrollerna för första och sista bildrutan förankrar tagningens slutpunkter och upp till fyra nyckelbildrutor kan fixera bilder vid mellanliggande tider. Tillverkarens nyckelbildsguide placerar dessa tider strikt inne i klippet på ett rutnät med en tredjedels sekund; två ankare som hamnar i samma tidsruta avvisas. Förbered ankare som hör till samma scen och beskriv rörelsen mellan dem. För ett produktavslöjande kan öppningen visa den stängda displayen och slutbilden det avslöjade objektet. För en loop kan samma bild fungera som första och sista bildruta. Lyssna och se genom övergången i stället för att bara bedöma de fixerade bilderna.
Vanlig text- och bild-till-video stöder klipp på 1–15 sekunder och utdata i 480p, 720p eller direkt renderad 1080p. Referens-till-video är begränsad till 720p. Textbaserat bildutsnitt omfattar 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 och 5:2. Välj längd och form efter handling och mål. Tillverkaren genererar ljud som standard och dokumenterar ett alternativ för tyst video. Ett uppdrag kan ange den talade repliken, närliggande effekter och avlägsen atmosfär så att ljudet bidrar till samma scen i stället för att bli en ospecificerad bakgrund.
Det dokumenterade genereringsflödet är asynkront: det returnerar en begäransidentifierare och sedan ett färdigt resultat med klippets adress och längd. Exempelresultatet pekar på en MP4-video och den värdlagrade utdataadressen är tillfällig. Spara det färdiga klippet och indatuppdraget när du förbereder en redigering. Kontrollera kontinuitet, objekts beständighet, rörelse, bildutsnitt och ljud mot den avsedda tagningen. En mellanliggande bearbetningspost är användbar för att spåra arbetet, medan den spelbara videon är leveransen att granska.
Versionsskillnader påverkar planen. Lite hanterar enkel text- eller enbildsanimation, med ett 1080p-alternativ uppskalat från 720p. Fullständiga 1.5 lägger till referensbilder, förinställda röster och fixerade bildrutor. Den klassiska Grok Imagine Video-versionen erbjuder redigering och förlängning av befintliga videor. Utgåvans separata hastighetssiffror för Video 1.5 Fast gäller den namngivna varianten och definierar inte en fast färdigställandetid för denna modell. Iscensätt sammanhängande korta tagningar för en längre sekvens och granska karaktärs-, produkt- och ljudkontinuitet när klippen ordnas tillsammans.
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 skapar korta videor med synkroniserat ljud från text, en startbild eller visuella referenser. Den erbjuder direkt generering i 1080p från text/bild, upp till 14 referensbilder och tre förinställda röster samt kontroller för första, sista och mellanliggande bildrutor för att styra karaktärs- och produktscener.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Video POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video- Utdataformat
- ursprungliga MP4-byte; ingen normalisering/omkodning
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser x-ai/grok-imagine-video-1.5 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältduration | Typinteger | KravObligatoriskt | Värden & gränser 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480p, 720p, 1080p | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Standard— |
Fältgenerate_audio | Typboolean | KravValfritt | Värden & gränser false | Standard— |
Fältframe_images | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 Indatainnehåll: Array med bildruteobjekt. Varje objekt har type=image_url, image_url som innehåller url samt frame_type. Använd en HTTPS URL till en bild och sätt frame_type till first_frame. Varje bildruteroll förekommer högst en gång. Exakta nycklar: type, image_url, frame_type Villkor: Dessa nycklar beskriver varje bildruteobjekt; image_url innehåller endast url. Utelämna frame_images för en begäran med enbart text. | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser | Standard— |
Fältcallback_url | Typstring | KravValfritt | Värden & gränser Mönster: ^https:// | Standard— |
Fältsession_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fälttrace | Typobject | KravValfritt | Värden & gränser | Standard— |
Fältuser | Typstring | KravValfritt | Värden & gränser | Standard— |
Kombinationer av indatamaterial
Text till video · En skriven prompt. · Krävs: model, prompt, duration
Ange prompt som text och längd i hela sekunder. Välj en upplösning som stöds och vid behov ett bildförhållande.
model: Typ: string · x-ai/grok-imagine-video-1.5
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Bild till video · En skriven prompt och en bild för den första bildrutan. · Krävs: model, prompt, duration, frame_images
frame_images är en array. Varje bildruteobjekt har type, image_url och frame_type; image_url innehåller url. Sätt type till image_url. Använd first_frame. Varje bildruteroll förekommer högst en gång. Ange en offentlig HTTPS URL till en bild för varje bildruta. Välj en upplösning som stöds och vid behov ett bildförhållande.
Exakta nycklar: type, image_url, frame_type
model: Typ: string · x-ai/grok-imagine-video-1.5
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt, duration |
Parametermaterial_types | Avtaltext, image |
Parameteradditional_properties | Avtalfalse |
Parameteroptional_controls | Avtalresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Livscykel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Debiteringsvillkor | Avgift |
|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Debiteringsvillkor— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationIndatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper bild | DebiteringsvillkorInget ytterligare villkor anges i denna prisnyckel. | Avgift Indata · Indatabild · Uppskattning endast för jämförelse $0.02 per bild |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 1080p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.5 per videosekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.16 per videosekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 720p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.28 per videosekund |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Debiteringsvillkor— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.16 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Detaljer om referenstariffen
Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.
Prisreferenser för videokonfigurationer
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Debiteringsvillkor | Avgift |
|---|---|---|
| KonfigurationIndatabild | DebiteringsvillkorInget ytterligare villkor anges i denna prisnyckel. | Avgift Indata · Indatabild $0.02 per bild Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris $0.16 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 720p | Avgift Utdata · Videopris $0.28 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 1080p | Avgift Utdata · Videopris $0.5 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
Exempelbegäranden
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
Ta emot och spara resultat
Ailoot Ultra · Video
signerade innehållslänkar som du äger
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontrollera 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
Andra innehållsläsningar
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
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll varje faktiskt resultat som du äger och dess returnerade, uppmätta metadata.
Om det ursprungliga svaret behöver kontrolleras
503 result_pending_check + ursprungligt id + X-Should-Retry:false; upprepa aldrig originalet
Svarsfält
| Fält | Typ | Betydelse |
|---|---|---|
Fältindex | Typinteger | BetydelseNollbaserad position för denna video i utdatalistan. |
Fältcontent_url | Typstring | BetydelseSignerad HTTPS URL för hämtning av denna färdiga video. |
Fältsha256 | Typstring | null | BetydelseSHA-256-kontrollsumma för den ursprungliga videons byte; null om den inte är tillgänglig. |
Fältsize_bytes | Typinteger | null | BetydelseStorleken på den ursprungliga videofilen i byte; null om den inte är tillgänglig. |
Fältduration_ms | Typinteger | null | BetydelseUppmätt videolängd i millisekunder; null om den inte är tillgänglig. |
Fältwidth | Typinteger | null | BetydelseVideobredd i pixlar; null om den inte är tillgänglig. |
Fältheight | Typinteger | null | BetydelseVideohöjd i pixlar; null om den inte är tillgänglig. |
Fältvideo_codec | Typstring | null | BetydelseIdentifierare för videokodek; null om ingen har registrerats. |
Fälthas_audio | Typboolean | null | BetydelseOm videon innehåller ett ljudspår; null om detta inte har mätts. |
Fältaudio_codec | Typstring | null | BetydelseIdentifierare för ljudkodek; null när ingen identifierare har registrerats. |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar404 · not_found_error | VillkorVideoåtkomst är inte tillgänglig eller detta video-ID hittades inte. | Nästa stegKontrollera videoåtkomst. För en befintlig video använder du dess ursprungliga offentliga ID och samma API-nyckel. |
Svar401 · authentication_error | VillkorAPI-nyckeln motsvarar inte det autentiserade kontot. | Nästa stegKontrollera din API-nyckel och kontoåtkomst innan du skickar in. |
Svar400 · invalid_request_error | VillkorBegäran kunde inte läsas eller hämtningsindexet är ogiltigt. | Nästa stegKorrigera begäranskroppen. Vid hämtning väljer du ett utdataindex som returnerats av den ursprungliga uppgiften. |
Svar422 · price_unavailable | VillkorDen valda videokonfigurationen kan inte prissättas. | Nästa stegVälj en videokonfiguration som stöds och fyll i dess obligatoriska alternativ innan du skickar en korrigerad begäran. |
Svar422 · invalid_request_error | VillkorVideoindata eller den ursprungliga fortsättningsuppgiften är ogiltig. | Nästa stegAnvänd giltiga HTTPS-indata. För fortsättning använder du det färdiga originalets offentliga video-ID med samma API-nyckel. |
Svar402 · billing_error | VillkorDet tillgängliga saldot eller gränserna medger ingen reservation. | Nästa stegKontrollera ditt tillgängliga saldo och dina gränser innan du skickar en ny begäran. |
Svar503 · server_error | VillkorVideoverifiering, lagring eller tjänsteåtkomst är tillfälligt otillgänglig. | Nästa stegVänta tills tjänsten är tillgänglig. Om du redan har ett video-ID kontrollerar du den ursprungliga uppgiften i stället för att skapa en ny generering. |
Svar503 · result_pending_check | VillkorDet ursprungliga videoresultatet och debiteringen behöver kontrolleras. | Nästa stegBehåll det returnerade video-ID:t och kontrollera den uppgiften. Skicka ingen ersättande genereringsbegäran medan den kontrolleras. |
Svar503 · owned_result_unavailable | VillkorHämtningen av den befintliga videon är tillfälligt otillgänglig. | Nästa stegKontrollera samma videouppgift senare och hämta dess befintliga resultat. En ny generering skapar en separat operation. |
Svar409 · video_not_ready | VillkorVideoinnehållet har inte publicerats. | Nästa stegKontrollera den ursprungliga uppgiftens status. Hämta när den rapporterar completed; om den rapporterar failed följer du dess meddelande om debiteringskontroll. |
Alias
Modellalias
Ailoot Ultra x-ai/grok-imagine-video-1.5
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · SpaceXAI: Grok Imagine Video 1.5
- Vilka indata och resultat finns?
POST /v1/videos·x-ai/grok-imagine-video-1.5:text,image→video- Vilka fält använder begäran?
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- Vilka gränser gäller?
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