Grok Imagine Video API

Видео Grok: по описанию, из картинки или по референсам, правка и продолжение вашего ролика. Две модели: Grok с роликами до 30 секунд и Grok Pro.

Разработчик: xAIКлюч модели в API: grok_video

Для нейросети:Скачать .md Вся документация .md Открыть как текст

Подключение в три шага

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "grok_video",
  "settings": {
    "mode": "text_to_video",
    "prompt": "Лиса бежит по заснеженному лесу, камера движется рядом",
    "model": "grok",
    "aspect_ratio": "16:9",
    "duration": 10
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "grok_video",
    "settings": {
        "mode": "text_to_video",
        "prompt": "Лиса бежит по заснеженному лесу, камера движется рядом",
        "model": "grok",
        "aspect_ratio": "16:9",
        "duration": 10,
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "grok_video",
  "settings": {
    "mode": "text_to_video",
    "prompt": "Лиса бежит по заснеженному лесу, камера движется рядом",
    "model": "grok",
    "aspect_ratio": "16:9",
    "duration": 10
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Получить ключ

Цена до запуска

Цены на 15.10.2026: от 8 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
По описанию	от 8 ₽
Grok model = grok	от 18 ₽
Grok Pro model = grok_pro	от 8 ₽
Из картинки	от 9 ₽
Grok model = grok	от 9 ₽
Grok Pro model = grok_pro	от 9 ₽
Правка видео с файлом на 1 с	от 12 ₽
Продолжение видео с файлом на 2 с	от 44 ₽

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "grok_video",
  "settings": {
    "mode": "text_to_video",
    "prompt": "Лиса бежит по заснеженному лесу, камера движется рядом",
    "model": "grok",
    "aspect_ratio": "16:9",
    "duration": 10
  }
}'

amount_minor: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле mode.

По описанию mode = text_to_video
Из картинки mode = image_to_video
Правка видео mode = video_to_video
Продолжение видео mode = video_extend

По описанию

Видео только по тексту, файлы не передаются.

Значение поля mode: text_to_video

Цена в этом режиме от 8 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео. У Grok до 5000 символов, у Grok Pro до 4096 знаков латиницей, русская буква у него считается за две.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
modelНеобязательно: Модель. Grok дешевле, ролик до 30 секунд, есть режимы генерации. Grok Pro качественнее, ролик до 15 секунд.
Тип: СтрокаДопустимые значения: grokgrok_proПо умолчанию: "grok"
generation_modeНеобязательно: Настроение ролика у Grok, варианты в списке. У Grok Pro настроений нет, оставьте «Обычный».
Тип: СтрокаДопустимые значения: normalfunspicyПо умолчанию: "normal"
aspect_ratioНеобязательно: Пропорции видео. У Grok Pro их больше: ещё 4:3 и 3:4.
Тип: СтрокаДопустимые значения: 16:99:161:13:22:3Набор зависит от model.
Исключения
model aspect_ratio
grok_pro и ещё 4:3, 3:4
По умолчанию: "9:16"
qualityНеобязательно: Разрешение видео. 720p дороже.
Тип: СтрокаДопустимые значения: 480p720pПо умолчанию: "480p"
durationНеобязательно: Длина видео в секундах: у Grok от 6 до 30, у Grok Pro от 1 до 15. Цена за каждую секунду.
Тип: Целое числоМинимум: 1Максимум: 30По умолчанию: 6

`model`	`aspect_ratio`
`grok_pro`	и ещё `4:3`, `3:4`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true

Входные данные

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Видео по описанию

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "text_to_video",
    "prompt": "Лиса бежит по заснеженному лесу, камера движется рядом",
    "model": "grok",
    "aspect_ratio": "16:9",
    "duration": 10
  }
}

Grok Pro в 720p

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "text_to_video",
    "prompt": "Бармен подбрасывает шейкер и ловит его за спиной, тёплый свет бара",
    "model": "grok_pro",
    "aspect_ratio": "4:3",
    "quality": "720p",
    "duration": 8
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация занимает от 2 до 5 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Из картинки

Видео начинается с вашей картинки, или модель берёт персонажей и предметы с картинок-референсов. Нужна картинка или хотя бы один референс.

Значение поля mode: image_to_video

Цена в этом режиме от 9 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео. До 4096 символов, у Grok с референсами до 5000. Grok Pro считает русскую букву за две.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
modelНеобязательно: Модель. Grok дешевле, ролик до 30 секунд, есть режимы генерации. Grok Pro качественнее, ролик до 15 секунд.
Тип: СтрокаДопустимые значения: grokgrok_proПо умолчанию: "grok"
image_urlsНеобязательно: Одна ссылка на картинку, с которой начнётся видео. Можно не давать, если есть референсы.
Тип: Список (Строка, uri)Максимум элементов: 1
reference_image_urlsНеобязательно: До 7 ссылок на картинки с персонажами, предметами или стилем. У Grok вместе с главной картинкой не больше 7, Grok Pro главную картинку вместе с референсами не берёт.
Тип: Список (Строка, uri)Максимум элементов: 7
generation_modeНеобязательно: Настроение ролика: «Обычный» или «Весёлый». Работает только у Grok с референсами, в остальных случаях оставьте «Обычный».
Тип: СтрокаДопустимые значения: normalfunПо умолчанию: "normal"
aspect_ratioНеобязательно: Пропорции видео. Auto только у Grok с одной главной картинкой без референсов, 4:3 и 3:4 у Grok с референсами недоступны.
Тип: СтрокаДопустимые значения: 16:99:161:14:33:43:22:3autoНабор зависит от model.
Исключения
model aspect_ratio
grok_pro кроме auto
По умолчанию: "9:16"
qualityНеобязательно: Разрешение видео. 720p дороже.
Тип: СтрокаДопустимые значения: 480p720pПо умолчанию: "480p"
durationНеобязательно: Длина видео в секундах: от 1 до 15, у Grok с референсами от 6 до 30, у Grok Pro с референсами до 10. Цена за каждую секунду.
Тип: Целое числоМинимум: 1Максимум: 30По умолчанию: 6

`model`	`aspect_ratio`
`grok_pro`	кроме `auto`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true

Входные данные

Картинки передаются ссылками на JPEG, PNG или WebP до 10 МБ каждая.
У Grok с одной картинкой (главной или единственным референсом) пропорции видео берутся у картинки. У Grok Pro главная картинка растягивается под выбранные пропорции.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`image_urls`	Картинки	jpeg, jpg, png, webp	1	10 МБ
`reference_image_urls`	Картинки	jpeg, jpg, png, webp	7	10 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Оживить картинку

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "image_to_video",
    "prompt": "Камера медленно наезжает, волосы героини развеваются на ветру",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "duration": 8
  }
}

Персонаж с референсов

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "image_to_video",
    "prompt": "Этот персонаж в этом пальто идёт по ночному городу под дождём",
    "model": "grok_pro",
    "duration": 8,
    "reference_image_urls": [
      "https://example.com/character.png",
      "https://example.com/coat.png"
    ]
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация занимает от 2 до 5 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Правка видео

Grok Pro меняет ваш ролик по описанию: одежду, предметы, цвета. Остальное в кадре модель старается сохранить.

Значение поля mode: video_to_video

Цена в этом режиме от 12 ₽, с файлом на 1 с.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что изменить в ролике, до 4096 знаков латиницей: русская буква считается за две.
Тип: СтрокаМинимум символов: 1Максимум символов: 4096
video_urlsОбязательно: Одна ссылка на ролик MP4 не длиннее 8.7 секунды.
Тип: Список (Строка, uri)Максимум элементов: 1

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true model = "grok_pro"

Входные данные

Ролик передаётся ссылкой на MP4, адрес должен заканчиваться на .mp4. Длина не больше 8.7 секунды, ролик уходит целиком, обрезки нет.
Предела веса xAI не называет, 50 МБ это наш совет, а не его предел.
Цена за каждую секунду исходного ролика, неполная секунда считается целой. Считается как за 720p.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`video_urls`	Видео	mp4	1	50 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Надеть шляпу

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "video_to_video",
    "prompt": "Надень на героиню широкополую чёрную шляпу",
    "video_urls": [
      "https://example.com/clip.mp4"
    ]
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация занимает от 2 до 5 минут.
Длина и пропорции как у исходного ролика, разрешение как у него, но не выше 720p.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Продолжение видео

Grok Pro продолжает ваш ролик с его последнего кадра по описанию того, что будет дальше.

Значение поля mode: video_extend

Цена в этом режиме от 44 ₽, с файлом на 2 с.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит дальше, до 4096 знаков латиницей: русская буква считается за две.
Тип: СтрокаМинимум символов: 1Максимум символов: 4096
video_urlsОбязательно: Одна ссылка на ролик MP4 длиной от 2 до 15 секунд.
Тип: Список (Строка, uri)Максимум элементов: 1
durationНеобязательно: Длина продолжения в секундах, от 2 до 10. Каждая секунда продолжения добавляет к цене.
Тип: Целое числоМинимум: 2Максимум: 10По умолчанию: 6

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true model = "grok_pro"

Входные данные

Ролик передаётся ссылкой на MP4, адрес должен заканчиваться на .mp4. Длина от 2 до 15 секунд, ролик уходит целиком, обрезки нет.
Предела веса xAI не называет, 50 МБ это наш совет, а не его предел.
В цену входят секунды исходного ролика и секунды готового видео, то есть исходника вместе с продолжением. Неполная секунда считается целой, цена как за 720p.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`video_urls`	Видео	mp4	1	50 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Продолжить ролик

JSON

{
  "model": "grok_video",
  "settings": {
    "mode": "video_extend",
    "prompt": "Камера отъезжает и показывает весь город с высоты",
    "video_urls": [
      "https://example.com/clip.mp4"
    ],
    "duration": 6
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация занимает от 2 до 5 минут.
Готовое видео это исходный ролик вместе с продолжением. Пропорции и разрешение как у исходного, но не выше 720p.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Смотрите также

Попробуйте Grok Imagine Video через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API