grok-imagine-video
Grok Imagine Video skapar korta videor från textbeskrivningar med val av längd och bildformat. Modellen från xAI stöder även bildanimation och riktad videoredigering.
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.
Från beskrivning till video
Grok Imagine Video skapar video från text. Modellen från xAI har även lägen med ursprungsbild och video. I Ailoots publicerade genereringsmetod är indata en textbeskrivning och resultatet en video.
Genereringen är asynkron: först skapas en uppgift och sedan hämtas status och färdigt resultat via dess identifierare. Enligt xAI kan videoskapandet ta flera minuter. Tiden beror på scenens komplexitet, längd, upplösning och valt läge.
Längd och bild
För skapande av video finns längder från 1 till 15 sekunder. Bildformaten omfattar 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 och 2:3, med 16:9 som standardformat. Versionen erbjuder 480p och 720p, medan 1080p hör till version 1.5.
Animation av ursprungsbilden
I xAI:s bildläge blir bilden startbildrutan och textinstruktionen anger rörelsen. Videons form följer som standard ursprungsbildens proportioner. Ett uttryckligen angivet bildförhållande ändrar formen och kan sträcka bilden.
Riktad redigering
Vid arbete med färdig video tillämpar modellen de beskrivna ändringarna och bevarar scenens övriga innehåll. Läget hjälper till att ändra rätt element med ursprungsvideons iscensättning bevarad. Längd och proportioner ärvs från originalet. Ny längd eller bildform anges inte.
Ursprungsvideon för redigering är begränsad till 8,7 sekunder, och resultatet till en upplösning på högst 720p. Material i 1080p skalas ned till 720p. Inställningar för videogenerering från text överförs inte automatiskt till redigering.
Fortsättning på en färdig video
I ett separat xAI-läge fortsätter denna version ursprungsvideon från dess sista bildruta. Ursprunglig MP4 måste vara från 2 till 15 sekunder. Den tillagda delen är från 2 till 10 sekunder, med 6 som standard. Resultatet förenar ursprungsvideon och fortsättningen. Proportioner och upplösning ärvs från ursprungsmaterialet med en gräns på 720p. De kan inte ändras separat i läget. Tillverkarens möjlighet skiljer sig från Ailoots publicerade videogenerering från text.
Referenser och versionsgränser
xAI erbjuder visuella referenser för att styra utseendet på människor, kläder och föremål i scenen. Referensen anger visuella kännetecken, inte den första bildrutans exakta bild. För klassiska Grok Imagine Video kan startbildrutan inte kombineras med referenser.
Versionen tar inte emot exakt låsning av sista bildrutan eller mellanliggande nyckelbildrutor. Möjligheterna hör till Grok Imagine Video 1.5. Generering, animation av ursprungsbilden och ändring av färdig video är olika lägen. Ailoots publicerade metod beskriver här videogenerering från text.
Ailoot · Videor POST /v1/videos/generations grok-imagine-video
grok-imagine-videoStart
Grok Imagine Video skapar korta videor från textbeskrivningar med val av längd och bildformat. Modellen från xAI stöder även bildanimation och riktad videoredigering.
- Godkända indata
- Text
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot · Videor POST /v1/videos/generations
- Indatatyper
text- Utdatatyper
video- Utdataformat
- mp4
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser grok-imagine-video | Standard— |
Fältprompt | Typstring | KravValfritt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 15 Villkor: Ange inte både duration och seconds Enhet: sekunder | Standard1 |
Fältseconds | Typinteger|integer_string | KravValfritt | Värden & gränser Minimum: 1 Maximum: 15 Alternativ: duration | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480p, 720p | Standard480p |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Villkor: Om en indatabild anges och bildförhållandet utelämnas ärver leverantören bildens bildförhållande | Standard16:9 |
Fältsize | Typstring | KravValfritt | Värden & gränser 1280x720, 720x1280, 1920x1080, 1080x1920 Villkor: Måste stämma överens med resolution/aspect_ratio om båda anges | Standard— |
Fältimage | Typobject | KravValfritt | Värden & gränser Villkor: Faktisk indatabild som stöds; medger att prompt utelämnas | Standard— |
Kombinationer av indatamaterial
Text till video · Krävs: prompt
Bild till video · Krävs: image
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
Priser
Priser för Ailoot-metoder
POST /v1/videos/generations- Indata
- 0,002 US$ per indatabild
- Indata
- 0,01 US$ per sekund indatavideo
- Utdata
- 0,05 US$ per sekund vid 480p
- Utdata
- 0,07 US$ per sekund vid 720p
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 →
Exempelbegäranden
Ailoot · Videor
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'Ta emot och spara resultat
Ailoot · Videor
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kontrollera jobbstatus
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Andra innehållsläsningar
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll hela statusens JSON och det faktiska request_id. Ett färdigt svar med status=done innehåller video.url med en URL till innehåll som du äger. Bevara den rapporterade längden och varje returnerat resultatfält.
Om det ursprungliga svaret behöver kontrolleras
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
Svarsfält
| Fält | Typ |
|---|---|
Fältrequest_id | Typstring |
Fältid | Typstring |
Fältstatus | Typstring |
Fältvideo.url | Typowned signed content URL |
Fältvideo.duration | Typnumber |
Fältvideo.respect_moderation | Typboolean |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Alias
Modellalias
Ailoot grok-imagine-video
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · grok-imagine-video
- Vilka indata och resultat finns?
POST /v1/videos/generations·grok-imagine-video:text→video- Vilka fält använder begäran?
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Vilka gränser gäller?
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15