Grok Video API

Grok Video API

Grok Video делает короткие ролики длительностью от 6 до 30 секунд: оживляет готовые изображения или создаёт видео только по текстовому описанию. Сценарий задаётся параметром model:

• видео из изображений (grok-imagine/image-to-video) - передайте ссылки на изображения в image_urls и опишите, что должно происходить в кадре;
• видео из текста (grok-imagine/text-to-video) - достаточно задания и соотношения сторон.

Каждый запуск создаёт асинхронную операцию. Сразу после запроса API возвращает id, а готовое видео нужно получить отдельной проверкой статуса.

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

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

Если model не передан, используется grok-imagine/image-to-video, и тогда нужен image_urls. Поэтому для видео из текста всегда явно передавайте model.

Тело запроса

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

• tool - slug нейросети, всегда "grok-video".
• input - параметры запуска. Все поля передаются напрямую внутри этого объекта, без дополнительного вложенного объекта input.

Параметры

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

Видео из текста

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": 6,
    "resolution": "480p"
  }
}'

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: 6,
      resolution: '480p',
    },
  }),
})

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': 6,
            'resolution': '480p',
        },
    },
    timeout=30,
)

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

Видео из изображений

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": 10,
    "resolution": "720p"
  }
}'

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: 10,
      resolution: '720p',
    },
  }),
})

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': 10,
            'resolution': '720p',
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "9f4d2f65-4b2c-4df8-bf2a-9c6e8b86b352",
  "status": "queued",
  "tool": "grok-video",
  "cost": 12,
  "balance_after": 488,
  "created_at": "2026-09-15T12:00:00Z"
}

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

{
  "id": "9f4d2f65-4b2c-4df8-bf2a-9c6e8b86b352",
  "status": "completed",
  "tool": "grok-video",
  "cost": 12,
  "created_at": "2026-09-15T12:00:00Z",
  "completed_at": "2026-09-15T12:01:30Z",
  "result": {
    "type": "video",
    "urls": [
      "https://af778c3b-be3c-4447-a63c-25ebabf0a68f.selstorage.ru/user_files/result-video-1.mp4"
    ]
  },
  "error_message": null
}

Ответ при ошибке выполнения

{
  "id": "9f4d2f65-4b2c-4df8-bf2a-9c6e8b86b352",
  "status": "failed",
  "tool": "grok-video",
  "cost": 12,
  "created_at": "2026-09-15T12:00:00Z",
  "completed_at": "2026-09-15T12:01:30Z",
  "result": null,
  "error_message": "Не удалось выполнить операцию"
}

Ответ при ошибке запроса

Если запрос не прошёл проверку, операция не создаётся и деньги не списываются:

{
  "error": {
    "code": "validation_error",
    "message": "Длительность видео должна быть от 6 до 30 секунд",
    "request_id": "0b6f1d7e-3a52-4c1e-9d0a-5f2f7c8e41b3"
  }
}

Основные коды: unauthorized - нет заголовка Authorization, invalid_api_key - ключ неверный или отключён, validation_error - ошибка в параметрах, insufficient_funds - не хватает средств на балансе.

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

После создания операции сохраните id из ответа и проверяйте статус этим запросом:

GET /api/v1/operations/{id}

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/9f4d2f65-4b2c-4df8-bf2a-9c6e8b86b352

JavaScript / TypeScript

const operationId = '9f4d2f65-4b2c-4df8-bf2a-9c6e8b86b352'

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

const operation = await response.json()
console.log(operation.status, operation.result)

Статус проходит путь queued -> processing -> completed или failed. Генерация видео занимает заметно больше времени, чем изображений, поэтому опрашивайте статус с паузой в несколько секунд. Проверять одну операцию чаще раза в секунду нельзя: API вернёт 429 с кодом rate_limit_exceeded.

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

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

{
  "type": "video",
  "urls": [
    "https://af778c3b-be3c-4447-a63c-25ebabf0a68f.selstorage.ru/user_files/result-video-1.mp4"
  ]
}

• type - тип результата, для этой нейросети это "video".
• urls - массив ссылок на готовые ролики в формате mp4. Даже если ролик один, он приходит в массиве.

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

Стоимость считается за секунду ролика и зависит только от разрешения:

Итоговая цена = цена за секунду × duration. Дробная длительность округляется вверх до целой секунды.

Примеры расчёта:

• 480p, 6 секунд - 12 ₽ (минимальная стоимость);
• 720p, 10 секунд - 30 ₽;
• 720p, 30 секунд - 90 ₽.

Цена не зависит от сценария, количества изображений и соотношения сторон. Итоговая стоимость приходит в поле cost сразу после создания операции. Если на балансе недостаточно средств, операция не будет создана, а API вернёт ошибку insufficient_funds.

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

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и повторно списывает стоимость при успешном создании.
• Операция выполняется асинхронно: после создания нужно проверять статус по id.
• Для файлов используйте только внешние http/https URL, доступные серверу без авторизации.
• Не используйте ссылки на localhost, приватные IP-адреса и внутренние адреса.
• Для image_urls можно передать до 7 изображений. В примере выше показаны две ссылки, но в реальном запросе можно отправить и одну.
• Форматы heic и heif по ссылке не принимаются: перед отправкой сконвертируйте их в jpg или png.
• Лучше всего работают задания, где описано движение: что делает объект, как движется камера, что меняется в кадре.