grok-imagine-video

Grok Imagine Video ұзақтық пен кадр форматын таңдап, мәтіндік сипаттама бойынша қысқа роликтер жасайды. xAI моделінің өзі сурет анимациясын және видеоны бағытталған өңдеуді де қолдайды.

Ailoot · Бейне POST /v1/videos/generations grok-imagine-video

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Сипаттамадан роликке дейін

Grok Imagine Video мәтін бойынша видео жасайды. xAI моделінің өзінде бастапқы суреті және видеосы бар режимдер де бар. Ailoot-тың жарияланған генерация әдісінде кіріс мәтіндік сипаттама, ал нәтиже ролик болады.

Генерация асинхронды орындалады: алдымен тапсырма жасалады, кейін оның идентификаторы бойынша күйі және дайын нәтижесі алынады. xAI дерегіне сәйкес, ролик жасау бірнеше минут алуы мүмкін; уақыт көрініс күрделілігіне, ұзақтығына, ажыратымдылығына және таңдалған режимге байланысты.

Ұзақтық және кадр

Ролик жасау үшін 1-ден 15 секундқа дейінгі ұзақтық қолжетімді. Кадр форматтары 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 және 2:3 қамтиды; стандарт формат — 16:9. Бұл нұсқада 480p және 720p қарастырылған, ал 1080p 1.5 нұсқасына жатады.

Бастапқы суретті анимациялау

xAI-дың суреті бар режимінде сурет бастапқы кадрға айналады, ал мәтіндік нұсқау қозғалысты белгілейді. Әдепкіде ролик пішіні бастапқы сурет пропорцияларын қайталайды. Анық берілген жақтар қатынасы бұл пішінді өзгертеді және суретті созуы мүмкін.

Бағытталған өңдеу

Дайын видеомен жұмыста модель көріністің қалған мазмұнын сақтап, сипатталған өзгерістерді қолданады. Бұл режим бастапқы ролик қойылымын сақтай отырып, қажетті элементті өзгертуге көмектеседі. Ұзақтық пен пропорциялар түпнұсқадан алынады; жаңа ұзақтық немесе кадр пішіні берілмейді.

Өңдеуге арналған бастапқы ролик 8,7 секундпен, ал нәтиже 720p-ден жоғары емес ажыратымдылықпен шектеледі. 1080p материал 720p-ге азайтылады. Мәтін бойынша генерация баптаулары өңдеуге автоматты түрде қолданылмайды.

Дайын роликті жалғастыру

xAI-дың бөлек режимінде бұл нұсқа бастапқы роликті соңғы кадрынан жалғастырады. Бастапқы MP4 2-ден 15 секундқа дейін, қосылатын бөлік 2-ден 10 секундқа дейін, әдепкіде 6 секунд болуы керек. Нәтиже бастапқы видео мен жалғасын біріктіреді. Пропорциялар мен ажыратымдылық бастапқы материалдан алынып, 720p шегі қолданылады; бұл режимде оларды бөлек өзгертуге болмайды. Өндірушінің бұл мүмкіндігі Ailoot-тың жарияланған мәтін бойынша генерациясынан өзгеше.

Референстер және нұсқа шекаралары

xAI көріністегі адамдардың, киімнің және заттардың сыртқы түрін бағыттау үшін визуалды референстер қолдануды қарастырады. Референс бірінші кадрдың нақты суретін емес, визуалды белгілерді береді. Классикалық Grok Imagine Video үшін бастапқы кадрды референстермен біріктіруге болмайды.

Бұл нұсқа соңғы кадрды дәл бекітуді және аралық негізгі кадрларды қабылдамайды. Мұндай мүмкіндіктер Grok Imagine Video 1.5-ке тиесілі. Генерация, бастапқы суретті анимациялау және дайын роликті өзгерту — әртүрлі режимдер; мұнда жарияланған Ailoot әдісі мәтін бойынша генерацияны сипаттайды.

Ailoot · Бейне POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot · Бейне POST /v1/videos/generations

Кіріс: text
Шығыс: video
Шығыс пішімі: mp4

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер grok-imagine-video	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`duration`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 15 Шарттар: duration және seconds өрістерін қатар бермеңіз Бірлік: секунд	Әдепкі1
Өріс`seconds`	Түрі`integer\|integer_string`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 15 Балама: duration	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 480p, 720p	Әдепкі480p
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Шарттар: Кіріс суреті беріліп, жақтар арақатынасы көрсетілмесе, жеткізуші суреттің жақтар арақатынасын қабылдайды	Әдепкі16:9
Өріс`size`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1280x720, 720x1280, 1920x1080, 1080x1920 Шарттар: Екеуі де көрсетілсе, resolution/aspect_ratio мәндерімен сәйкес келуі керек	Әдепкі—
Өріс`image`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Қолдау көрсетілетін нақты кіріс суреті; промптты қоспауға мүмкіндік береді	Әдепкі—

Кіріс материалдарының үйлесімдері

Мәтіннен бейне жасау · Міндетті: prompt

Суреттен бейне жасау · Міндетті: image

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`material_types`	Параметр талаптарыtext
Параметр`required`	Параметр талаптарыnull
Параметр`optional_controls`	Параметр талаптарыnull

Өмірлік цикл: 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

Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.

Тарифтер

Ailoot әдістерінің мөлшерлемелері

Ailoot БейнеPOST /v1/videos/generations

Кіріс: 0,002 $ кіріс суреті үшін
Кіріс: 0,01 $ кіріс бейненің секунды үшін
Шығыс: 0,05 $ 480p ажыратымдылықта секундына
Шығыс: 0,07 $ 720p ажыратымдылықта секундына

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot · Бейне

Бейне мысалы

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

Нәтижелерді алу және сақтау

Ailoot · Бейне

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

Тапсырма күйін тексеру

GET күйі

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"

Басқа мазмұнды оқу

GET мазмұн

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

Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.

Күйдің JSON жауабын толық және нақты request_id мәнін сақтаңыз. status=done болатын аяқталған жауапта иелігіңіздегі мазмұнның URL мекенжайы бар video.url өрісі болады. Көрсетілген ұзақтықты және қайтарылған әрбір нәтиже өрісін сақтаңыз.

Бастапқы жауапты тексеру қажет болса

Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`request_id`	Түріstring
Өріс`id`	Түріstring
Өріс`status`	Түріstring
Өріс`video.url`	Түріowned signed content URL
Өріс`video.duration`	Түріnumber
Өріс`video.respect_moderation`	Түріboolean

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате	Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.
Жауап409 · `video_not_ready`	ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес	Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз.
Жауап`server_error`	ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген	Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot grok-imagine-video

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

grok-imagine-video

FAQ · grok-imagine-video

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/videos/generations · grok-imagine-video: text → video
Сұрау қандай өрістерді пайдаланады?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Қандай шектеулер қолданылады?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video