Grok Video API

Grok Video API

Grok Video генерирует короткие видео по текстовому описанию или оживляет загруженные изображения (до 7) по текстовой инструкции. Запрос создаёт асинхронную операцию: сначала вы получаете id и стартовый статус, а готовый mp4 забираете позже через проверку операции по id.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Запрос создаёт операцию и сразу возвращает её id, стартовый статус и стоимость.
• Выполнение асинхронное.

Grok Video поддерживает два сценария:

• grok-imagine/text-to-video - генерация видео из текста.
• grok-imagine/image-to-video - генерация видео по изображениям (до 7) и текстовой инструкции.

Тело запроса

Базовая форма запроса:

{
  "tool": "grok-video",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети.
• input - параметры конкретного сценария.
• Набор полей зависит от выбранного model.

Параметры

Параметр	Тип	Обязательный	Описание
model	string	Да	Сценарий генерации. Доступные значения: grok-imagine/text-to-video и grok-imagine/image-to-video.
prompt	string	Да	Текстовое описание того, какое видео нужно получить. Максимум 5000 символов.
image_urls	string[]	Да, для grok-imagine/image-to-video	Массив внешних URL изображений. Можно использовать до 7 изображений. Разрешены только http/https ссылки на файлы .jpg, .jpeg, .png, .webp.
aspect_ratio	string	Нет, только для grok-imagine/text-to-video	Соотношение сторон итогового видео. Доступные значения: 16:9, 9:16, 1:1, 3:2, 2:3.
duration	integer	Да	Длительность видео в секундах. Допустимые значения: от 6 до 30.
resolution	string	Да	Разрешение видео. Доступные значения: 480p, 720p.
mode	string	Да	Режим генерации. Доступные значения: normal, fun, spicy. Значение spicy доступно только для grok-imagine/text-to-video.

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

Сценарий 1. Видео из текста

cURL

curl -X POST https://bratuha.ru/api/v1/operations \\
  -H "Authorization: Bearer brth_ваш_ключ" \\
  -H "Content-Type: application/json" \\
  -d '{
    "tool": "grok-video",
    "input": {
      "model": "grok-imagine/text-to-video",
      "prompt": "Ночной пролёт камеры над футуристическим городом, мокрый асфальт, неоновые вывески, кинематографичный свет",
      "aspect_ratio": "16:9",
      "duration": 10,
      "resolution": "720p",
      "mode": "normal"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'grok-video',
    input: {
      model: 'grok-imagine/text-to-video',
      prompt:
        'Ночной пролёт камеры над футуристическим городом, мокрый асфальт, неоновые вывески, кинематографичный свет',
      aspect_ratio: '16:9',
      duration: 10,
      resolution: '720p',
      mode: 'normal',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "grok-video",
        "input": {
            "model": "grok-imagine/text-to-video",
            "prompt": "Ночной пролёт камеры над футуристическим городом, мокрый асфальт, неоновые вывески, кинематографичный свет",
            "aspect_ratio": "16:9",
            "duration": 10,
            "resolution": "720p",
            "mode": "normal",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 2. Видео по изображениям

cURL

curl -X POST https://bratuha.ru/api/v1/operations \\
  -H "Authorization: Bearer brth_ваш_ключ" \\
  -H "Content-Type: application/json" \\
  -d '{
    "tool": "grok-video",
    "input": {
      "model": "grok-imagine/image-to-video",
      "prompt": "Девушка плавно поворачивает голову к камере и улыбается, лёгкое движение волос, естественная мимика",
      "image_urls": [
        "https://cdn.example.com/source-image-1.jpg",
        "https://cdn.example.com/source-image-2.jpg"
      ],
      "duration": 6,
      "resolution": "480p",
      "mode": "fun"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'grok-video',
    input: {
      model: 'grok-imagine/image-to-video',
      prompt:
        'Девушка плавно поворачивает голову к камере и улыбается, лёгкое движение волос, естественная мимика',
      image_urls: [
        'https://cdn.example.com/source-image-1.jpg',
        'https://cdn.example.com/source-image-2.jpg',
      ],
      duration: 6,
      resolution: '480p',
      mode: 'fun',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "grok-video",
        "input": {
            "model": "grok-imagine/image-to-video",
            "prompt": "Девушка плавно поворачивает голову к камере и улыбается, лёгкое движение волос, естественная мимика",
            "image_urls": [
                "https://cdn.example.com/source-image-1.jpg",
                "https://cdn.example.com/source-image-2.jpg"
            ],
            "duration": 6,
            "resolution": "480p",
            "mode": "fun",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания операции

{
  "id": "op_8f3c2b1a",
  "status": "queued",
  "tool": "grok-video",
  "cost": 30,
  "balance_after": 470,
  "created_at": "2026-03-16T12:00:00Z"
}

Ответ после завершения операции

{
  "id": "op_8f3c2b1a",
  "status": "completed",
  "tool": "grok-video",
  "cost": 30,
  "created_at": "2026-03-16T12:00:00Z",
  "completed_at": "2026-03-16T12:00:38Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/grok-video/result-video.mp4"
    ]
  },
  "error_message": null
}

Ответ с ошибкой

{
  "id": "op_8f3c2b1a",
  "status": "failed",
  "tool": "grok-video",
  "cost": 20,
  "created_at": "2026-03-16T12:00:00Z",
  "completed_at": "2026-03-16T12:00:11Z",
  "result": null,
  "error_message": "Произошла ошибка, сервис временно недоступен. Попробуйте повторить запрос позже."
}

Проверка статуса

Сохраните id операции из ответа на POST /api/v1/operations, затем проверяйте статус через GET /api/v1/operations/{id}.

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \\
  https://bratuha.ru/api/v1/operations/op_8f3c2b1a

JavaScript / TypeScript

const response = await fetch(
  'https://bratuha.ru/api/v1/operations/op_8f3c2b1a',
  {
    headers: {
      Authorization: 'Bearer brth_ваш_ключ',
    },
  }
)

const data = await response.json()
console.log(data)

Формат результата

После успешного завершения в result возвращается видео:

• type: "video"
• urls - массив ссылок на готовые mp4-файлы

Для Grok Video обычно возвращается одна ссылка на итоговый mp4-файл.

Ценообразование

Цена рассчитывается по формуле: длительность (сек) × ставка за секунду.

Разрешение	Ставка	Пример (10 сек)	Пример (30 сек)
480p	2 ₽/сек	20 ₽	60 ₽
720p	3 ₽/сек	30 ₽	90 ₽

Минимальная длительность — 6 секунд, максимальная — 30 секунд.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.
• Все операции выполняются асинхронно, поэтому после создания нужно опрашивать статус по id.
• Для image_urls используйте только внешние http/https URL.
• Public API для URL-изображений принимает только .jpg, .jpeg, .png, .webp.
• Для grok-imagine/image-to-video можно использовать до 7 изображений.
• Параметр aspect_ratio нужен только для grok-imagine/text-to-video.
• Режим spicy нельзя использовать в grok-imagine/image-to-video.
• Длительность duration передаётся числом (6-30), не строкой.
• Если сервис не смог выполнить генерацию или запрос не прошёл модерацию, операция завершится со статусом failed, а причина будет в error_message.