grok-imagine-video

Grok Imagine Video ustvarja kratke posnetke po besedilnem opisu z izbiro trajanja in formata kadra. Sam model družbe xAI podpira tudi animacijo slike in usmerjeno urejanje videa.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Od opisa do posnetka

Grok Imagine Video ustvarja video iz besedila. Sam model družbe xAI ima tudi načina z izvirno sliko in videom. V objavljenem načinu ustvarjanja Ailoot je vhod besedilni opis, rezultat pa posnetek.

Ustvarjanje poteka asinhrono: najprej se ustvari naloga, nato se po njenem identifikatorju pridobita stanje in končni rezultat. Po podatkih družbe xAI lahko ustvarjanje posnetka traja več minut; čas je odvisen od zahtevnosti scene, trajanja, ločljivosti in izbranega načina.

Trajanje in kader

Za ustvarjanje posnetka je na voljo trajanje od 1 do 15 sekund. Formati kadra vključujejo 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 in 2:3; običajni format je 16:9. Pri tej različici sta predvideni 480p in 720p, 1080p pa velja za različico 1.5.

Animacija izvirne slike

V načinu xAI s sliko ta postane začetni kader, besedilno navodilo pa določa gibanje. Privzeto oblika posnetka ponovi razmerje stranic izvirne slike. Izrecno določeno razmerje stranic spremeni to obliko in lahko sliko raztegne.

Usmerjeno urejanje

Pri delu s končnim videom model uporabi opisane spremembe in ohrani preostalo vsebino scene. Ta način pomaga spremeniti želeni element ob ohranitvi postavitve izvirnega posnetka. Trajanje in razmerje stranic se podedujeta od izvirnika; novo trajanje ali oblika kadra se ne določata.

Izvirni posnetek za urejanje je omejen na 8,7 sekunde, rezultat pa na ločljivost največ 720p. Gradivo v 1080p se zmanjša na 720p. Nastavitve ustvarjanja iz besedila se ne prenašajo samodejno na urejanje.

Nadaljevanje končnega posnetka

V ločenem načinu xAI ta različica nadaljuje izvirni posnetek od njegovega zadnjega kadra. Izvirni MP4 mora trajati od 2 do 15 sekund; dodani del od 2 do 10 sekund, privzeto 6. Rezultat združi izvirni video in nadaljevanje. Razmerje stranic in ločljivost se podedujeta od izvirnika z omejitvijo 720p; v tem načinu ju ni mogoče ločeno spreminjati. Ta zmožnost proizvajalca se razlikuje od objavljenega ustvarjanja Ailoot iz besedila.

Referenčne slike in meje različice

xAI predvideva uporabo vizualnih referenc za usmerjanje videza ljudi, oblačil in predmetov v sceni. Referenca določa vizualne značilnosti in ne natančne slike prvega kadra. Pri klasičnem Grok Imagine Video začetnega kadra ni mogoče združiti z referencami.

Ta različica ne sprejema natančne določitve zadnjega kadra in vmesnih ključnih kadrov. Te zmožnosti pripadajo Grok Imagine Video 1.5. Ustvarjanje, animacija izvirne slike in spreminjanje končnega posnetka so različni načini; objavljeni način Ailoot tu opisuje ustvarjanje iz besedila.

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

grok-imagine-video

xAI /grok-imagine-video

Začetek

Grok Imagine Video ustvarja kratke posnetke po besedilnem opisu z izbiro trajanja in formata kadra. Sam model družbe xAI podpira tudi animacijo slike in usmerjeno urejanje videa.

Dovoljeni vhodi: Besedilo
Rezultati: Video

Na voljo v Ailoot · vhodi in metode

Ailoot · Videoposnetki POST /v1/videos/generations

Vhod: text
Izhod: video
Izhodni format: mp4

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve grok-imagine-video	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`duration`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 15 Pogoji: Ne podajte hkrati duration in seconds Enota: sekunde	Privzeto1
Polje`seconds`	Vrsta`integer\|integer_string`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 15 Alternativa: duration	Privzeto—
Polje`resolution`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 480p, 720p	Privzeto480p
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Pogoji: Če je podana vhodna slika in je razmerje izpuščeno, ponudnik prevzame razmerje stranic slike	Privzeto16:9
Polje`size`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1280x720, 720x1280, 1920x1080, 1080x1920 Pogoji: Če sta podana oba, se mora ujemati z resolution/aspect_ratio	Privzeto—
Polje`image`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Dejanska podprta vhodna slika; omogoča izpustitev poziva	Privzeto—

Kombinacije vhodnih gradiv

Iz besedila v video · Obvezno: prompt

Iz slike v video · Obvezno: image

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`material_types`	Specifikacijatext
Parameter`required`	Specifikacijanull
Parameter`optional_controls`	Specifikacijanull

Življenjski cikel: 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

Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.

Cenik

Cene metod Ailoot

Ailoot VideoposnetkiPOST /v1/videos/generations

Vhod: 0,002 $ na vhodno sliko
Vhod: 0,01 $ na sekundo vhodnega videa
Izhod: 0,05 $ na sekundo pri 480p
Izhod: 0,07 $ na sekundo pri 720p

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot · Videoposnetki

Primer videa

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

Prejmi in shrani rezultate

Ailoot · Videoposnetki

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

Preveri stanje opravila

GET stanje

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"

Branje druge vsebine

GET vsebina

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

Ohrani vse dokončane rezultate

Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.

Ohranite celoten JSON stanja in dejanski request_id. Dokončan odgovor s status=done vsebuje video.url z URL-jem vsebine v vaši lasti. Ohranite navedeno trajanje in vsako vrnjeno polje rezultata.

Če je treba preveriti izvirni odgovor

Berite obstoječe prvotno opravilo; neznane oddaje nikoli ne ponovite.

Polja odgovora

Polje	Vrsta
Polje`request_id`	Vrstastring
Polje`id`	Vrstastring
Polje`status`	Vrstastring
Polje`video.url`	Vrstaowned signed content URL
Polje`video.duration`	Vrstanumber
Polje`video.respect_moderation`	Vrstaboolean

Napake in naslednji koraki

Odgovor	Pogoj	Naslednji korak
Odgovor400 · `invalid_request_error`	PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra	Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja.
Odgovor409 · `video_not_ready`	PogojPrvotna vsebina rezultata še ni na voljo	Naslednji korakPreverjajte prvotni vrnjeni ID in upoštevajte Retry-After.
Odgovor`server_error`	PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti	Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova.

Druga imena

Druga imena modelov

Ailoot grok-imagine-video

Druga imena poti metod

Uporabite zgoraj navedene poti metod.

Povezani ID-ji za klic

grok-imagine-video

FAQ · grok-imagine-video

Kateri vhodi in rezultati so na voljo?: POST /v1/videos/generations · grok-imagine-video: text → video
Katera polja uporablja zahteva?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Katere omejitve veljajo?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video