grok-imagine-video
Grok Imagine Video tworzy krótkie filmy na podstawie opisu tekstowego z wyborem czasu trwania i formatu kadru. Sam model xAI obsługuje także animowanie obrazu i ukierunkowaną edycję wideo.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Od opisu do filmu
Grok Imagine Video tworzy wideo na podstawie tekstu. Sam model xAI ma także tryby z obrazem i wideo źródłowym. W opublikowanej metodzie generowania Ailoot wejściem jest opis tekstowy, a wynikiem — film.
Generowanie odbywa się asynchronicznie: najpierw tworzona jest operacja, a następnie przez jej identyfikator uzyskuje się stan i gotowy wynik. Według xAI tworzenie filmu może zajmować kilka minut; czas zależy od trudności sceny, długości, rozdzielczości i wybranego trybu.
Czas trwania i kadr
Dla tworzenia filmu dostępny jest czas trwania od 1 do 15 sekund. Formaty kadru obejmują 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 i 2:3; standardowy format to 16:9. Ta wersja przewiduje 480p i 720p, a 1080p należy do wersji 1.5.
Animowanie obrazu źródłowego
W trybie xAI z obrazem staje się on klatką początkową, a instrukcja tekstowa określa ruch. Domyślnie kształt filmu odpowiada proporcjom obrazu źródłowego. Jawnie określone proporcje zmieniają ten kształt i mogą rozciągnąć obraz.
Ukierunkowana edycja
Przy pracy z gotowym wideo model stosuje opisane zmiany, zachowując pozostałą treść sceny. Tryb ten pomaga zmienić potrzebny element przy zachowaniu inscenizacji filmu źródłowego. Czas trwania i proporcje są dziedziczone z oryginału; nie określa się nowego czasu ani kształtu kadru.
Film źródłowy do edycji jest ograniczony do 8,7 sekundy, a wynik — do rozdzielczości najwyżej 720p. Materiał w 1080p jest zmniejszany do 720p. Ustawienia generowania na podstawie tekstu nie przenoszą się automatycznie na edycję.
Kontynuowanie gotowego filmu
W osobnym trybie xAI ta wersja kontynuuje film źródłowy od jego ostatniej klatki. Źródłowy MP4 musi trwać od 2 do 15 sekund; dodawana część — od 2 do 10 sekund, domyślnie 6. Wynik łączy wideo źródłowe i kontynuację. Proporcje i rozdzielczość są dziedziczone ze źródła, z limitem 720p; nie można ich osobno zmieniać w tym trybie. Możliwość producenta różni się od opublikowanego generowania Ailoot na podstawie tekstu.
Obrazy referencyjne i granice wersji
xAI przewiduje używanie obrazów referencyjnych do ukierunkowania wyglądu ludzi, ubrań i przedmiotów w scenie. Obraz referencyjny określa cechy wizualne, a nie dokładny obraz pierwszej klatki. W klasycznym Grok Imagine Video nie można łączyć klatki początkowej z obrazami referencyjnymi.
Ta wersja nie przyjmuje dokładnego ustalenia ostatniej klatki ani pośrednich klatek kluczowych. Możliwości te należą do Grok Imagine Video 1.5. Generowanie, animowanie obrazu źródłowego i zmienianie gotowego filmu są różnymi trybami; opublikowana metoda Ailoot opisuje tutaj generowanie na podstawie tekstu.
Ailoot · Wideo POST /v1/videos/generations grok-imagine-video
grok-imagine-videoStart
Grok Imagine Video tworzy krótkie filmy na podstawie opisu tekstowego z wyborem czasu trwania i formatu kadru. Sam model xAI obsługuje także animowanie obrazu i ukierunkowaną edycję wideo.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- Wideo
Dostępne w Ailoot · dane wejściowe i metody
Ailoot · Wideo POST /v1/videos/generations
- Wejście
text- Wyjście
video- Format wyjściowy
- mp4
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity grok-imagine-video | Domyślnie— |
Poleprompt | Typstring | WymaganieOpcjonalne | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 15 Warunki: Nie podawaj jednocześnie duration i seconds Jednostka: sekundy | Domyślnie1 |
Poleseconds | Typinteger|integer_string | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 15 Alternatywa: duration | Domyślnie— |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 480p, 720p | Domyślnie480p |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Warunki: Jeśli podano obraz wejściowy i pominięto proporcje, dostawca przyjmuje proporcje obrazu | Domyślnie16:9 |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity 1280x720, 720x1280, 1920x1080, 1080x1920 Warunki: Musi odpowiadać resolution/aspect_ratio, jeśli podano oba | Domyślnie— |
Poleimage | Typobject | WymaganieOpcjonalne | Wartości i limity Warunki: Rzeczywisty obsługiwany obraz wejściowy; pozwala pominąć prompt | Domyślnie— |
Kombinacje materiałów wejściowych
Tekst na wideo · Wymagane: prompt
Obraz na wideo · Wymagane: image
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Cykl życia: 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
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
Cennik
Stawki metod Ailoot
POST /v1/videos/generations- Wejście
- 0,002 USD za obraz wejściowy
- Wejście
- 0,01 USD za sekundę wideo wejściowego
- Wyjście
- 0,05 USD za sekundę w 480p
- Wyjście
- 0,07 USD za sekundę w 720p
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot · Wideo
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."}'Odbieranie i zapisywanie wyników
Ailoot · Wideo
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Sprawdź status zadania
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"Inne odczyty treści
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.mp4Zachowaj wszystkie ukończone wyniki
Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Zachowaj kompletny JSON statusu i rzeczywiste request_id. Odpowiedź po ukończeniu ze status=done zawiera video.url z adresem URL treści należącej do użytkownika. Zachowaj podany czas trwania i każde zwrócone pole wyniku.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Odczytuj istniejące pierwotne zadanie; nigdy nie ponawiaj wysłania o nieznanym wyniku.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Polerequest_id | Typstring |
Poleid | Typstring |
Polestatus | Typstring |
Polevideo.url | Typowned signed content URL |
Polevideo.duration | Typnumber |
Polevideo.respect_moderation | Typboolean |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedź409 · video_not_ready | WarunekTreść pierwotnego wyniku nie jest jeszcze dostępna | Następny krokOdpytuj pierwotny zwrócony identyfikator i przestrzegaj Retry-After. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Aliasy
Aliasy modelu
Ailoot grok-imagine-video
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · grok-imagine-video
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos/generations·grok-imagine-video:text→video- Jakich pól używa żądanie?
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Jakie limity obowiązują?
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15