grok-imagine-video

Grok Imagine Video luo lyhyitä videoita tekstikuvauksesta keston ja kuvamuodon valinnalla. Itse xAI-malli tukee myös kuvan animointia ja kohdennettua videomuokkausta.

Ailoot · Videot POST /v1/videos/generations grok-imagine-video

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Kuvauksesta videoksi

Grok Imagine Video luo videon tekstistä. Itse xAI-mallilla on myös lähtökuvaa ja videota käyttävät tilat. Ailootin julkaistussa generointimenetelmässä syötteenä on tekstikuvaus ja tuloksena video.

Generointi suoritetaan asynkronisesti: ensin luodaan tehtävä, sitten sen tunnuksella saadaan tila ja valmis tulos. xAI:n mukaan videon luominen voi kestää useita minuutteja; aika riippuu näkymän vaativuudesta, kestosta, tarkkuudesta ja valitusta tilasta.

Kesto ja kuva

Luotavan videon kesto voi olla 1–15 sekuntia. Kuvamuodot sisältävät 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ja 2:3; oletusmuoto on 16:9. Tässä versiossa ovat 480p ja 720p, ja 1080p kuuluu versioon 1.5.

Lähtökuvan animointi

xAI:n kuvatilassa kuva toimii aloitusruutuna ja tekstiohje määrittää liikkeen. Oletuksena videon muoto noudattaa lähtökuvan kuvasuhdetta. Erikseen määritetty kuvasuhde muuttaa tätä muotoa ja voi venyttää kuvaa.

Kohdennettu muokkaus

Valmista videota käsitellessään malli soveltaa kuvatut muutokset säilyttäen näkymän muun sisällön. Tila auttaa muuttamaan tarvittavan elementin lähtövideon asetelmaa säilyttäen. Kesto ja kuvasuhde periytyvät alkuperäisestä; uutta kestoa tai kuvamuotoa ei määritetä.

Muokkauksen lähtövideo on rajattu 8,7 sekuntiin ja tulos enintään 720p-tarkkuuteen. 1080p-aineisto pienennetään 720p-tarkkuuteen. Tekstipohjaisen videogeneroinnin asetukset eivät siirry automaattisesti muokkaukseen.

Valmiin videon jatkaminen

Erillisessä xAI-tilassa tämä versio jatkaa lähtövideota sen viimeisestä ruudusta. MP4-lähtövideon keston on oltava 2–15 sekuntia; lisättävän osan 2–10 sekuntia, oletuksena 6. Tulos yhdistää alkuperäisen videon ja jatkon. Kuvasuhde ja tarkkuus periytyvät lähtöaineistosta enintään 720p-tarkkuudella; niitä ei voi muuttaa erikseen tässä tilassa. Tämä valmistajan kyky eroaa Ailootin julkaistusta tekstipohjaisesta videogeneroinnista.

Viiteaineistot ja version rajat

xAI mahdollistaa visuaaliset viiteaineistot ohjaamaan näkymän ihmisten, vaatteiden ja esineiden ulkonäköä. Viiteaineisto määrittää visuaaliset piirteet, ei ensimmäisen ruudun tarkkaa kuvaa. Klassiseen Grok Imagine Video -malliin ei voi yhdistää aloitusruutua ja viiteaineistoja.

Tämä versio ei tue viimeisen ruudun täsmällistä lukitsemista eikä välissä olevia avainruutuja. Nämä kyvyt kuuluvat Grok Imagine Video 1.5 -malliin. Generointi, lähtökuvan animointi ja valmiin videon muuttaminen ovat eri tiloja; Ailootin julkaistu menetelmä kuvaa tässä tekstipohjaista videogenerointia.

Ailoot · Videot POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Aloitus

Grok Imagine Video luo lyhyitä videoita tekstikuvauksesta keston ja kuvamuodon valinnalla. Itse xAI-malli tukee myös kuvan animointia ja kohdennettua videomuokkausta.

Hyväksytyt syötteet: Teksti
Tulokset: Video

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot · Videot POST /v1/videos/generations

Syötetyypit: text
Tulostyypit: video
Tulosteen muoto: mp4

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat grok-imagine-video	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`duration`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 15 Ehdot: Älä anna samanaikaisesti duration- ja seconds-kenttää Yksikkö: sekuntia	Oletus1
Kenttä`seconds`	Tyyppi`integer\|integer_string`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 15 Vaihtoehto: duration	Oletus—
Kenttä`resolution`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 480p, 720p	Oletus480p
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Ehdot: Jos kuvasyöte annetaan ja kuvasuhde jätetään pois, palveluntarjoaja perii kuvan kuvasuhteen	Oletus16:9
Kenttä`size`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1280x720, 720x1280, 1920x1080, 1080x1920 Ehdot: On vastattava resolution/aspect_ratio-arvoja, jos molemmat annetaan	Oletus—
Kenttä`image`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat Ehdot: Todellinen tuettu syötekuva; sallii kehotteen pois jättämisen	Oletus—

Syöteaineistojen yhdistelmät

Tekstistä videoksi · Pakollinen: prompt

Kuvasta videoksi · Pakollinen: image

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`material_types`	Sopimustext
Parametri`required`	Sopimusnull
Parametri`optional_controls`	Sopimusnull

Elinkaari: 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

Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.

Hinnoittelu

Ailoot-menetelmien hinnat

Ailoot VideotPOST /v1/videos/generations

Syöte: 0,002 $ syötekuvaa kohden
Syöte: 0,01 $ syötevideon sekuntia kohden
Tuloste: 0,05 $ sekuntia kohden 480p-tarkkuudella
Tuloste: 0,07 $ sekuntia kohden 720p-tarkkuudella

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot · Videot

Videoesimerkki

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."}'

Vastaanota ja tallenna tulokset

Ailoot · Videot

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Tarkista työn tila

GET tila

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"

Muut sisällön lukukerrat

GET sisältö

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.mp4

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.

Säilytä koko tilan JSON ja todellinen request_id. Valmistunut vastaus, jossa status=done, sisältää video.url-kentässä käyttäjälle kuuluvan sisällön URL-osoitteen. Säilytä ilmoitettu kesto ja jokainen palautettu tuloskenttä.

Jos alkuperäinen vastaus on tarkistettava

Lue olemassa olevan alkuperäisen työn tietoja; älä koskaan lähetä tuntemattomaan tilaan jäänyttä pyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`request_id`	Tyyppistring
Kenttä`id`	Tyyppistring
Kenttä`status`	Tyyppistring
Kenttä`video.url`	Tyyppiowned signed content URL
Kenttä`video.duration`	Tyyppinumber
Kenttä`video.respect_moderation`	Tyyppiboolean

Virheet ja seuraavat vaiheet

Vastaus	Ehto	Seuraava vaihe
Vastaus400 · `invalid_request_error`	EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo	Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä.
Vastaus409 · `video_not_ready`	EhtoAlkuperäisen tuloksen sisältö ei ole vielä saatavilla	Seuraava vaiheKysy tilaa alkuperäisellä palautetulla tunnisteella ja noudata Retry-After-otsaketta.
Vastaus`server_error`	EhtoPalautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta	Seuraava vaiheSäilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen.

Aliakset

Mallin aliakset

Ailoot grok-imagine-video

Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

Liittyvät kutsujan ID:t

grok-imagine-video

FAQ · grok-imagine-video

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/videos/generations · grok-imagine-video: text → video
Mitä kenttiä pyyntö käyttää?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Mitä rajoja sovelletaan?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video