Мост видео

Обзор

Video Bridge позволяет использовать генерацию xAI Grok Imagine Video через любую не-OpenAI модель, маршрутизируемую opencodex. Когда мост включён, в разговор добавляется синтетический tool video_gen. Модель вызывает его как обычный function tool; opencodex перехватывает вызов, отправляет job на генерацию видео в xAI, опрашивает её до завершения и скачивает результат.

Предварительные требования

Нужна запись провайдера xai с API-ключом (ocx login xai сам по себе недостаточен — video bridge требует key auth, а не OAuth)
Активной маршрутизируемой моделью должна быть не-OpenAI модель (например, Anthropic Claude или Google Gemini)
opencodex должен быть настроен на маршрутизацию через этого не-OpenAI провайдера

⚠ Provider key required: Video Bridge активируется только тогда, когда провайдер xai использует аутентификацию по API-ключу. Добавьте в конфигурацию:
{
  "providers": {
    "xai": { "adapter": "openai-chat", "apiKey": "xai-…", "authMode": "key" }
  }
}
Если вы подключали его через ocx login xai (OAuth), провайдер останется в authMode: "oauth", и bridge просто не активируется. Задайте XAI_API_KEY в окружении или укажите ключ прямо в конфигурации, как выше.

Конфигурация

Добавьте videoBridgeEnabled: true в раздел images:

{
  "images": {
    "bridgeEnabled": true,
    "videoBridgeEnabled": true,
    "videoBridgeModel": "grok-imagine-video",
    "videoMaxRounds": 2,
    "videoTimeoutMs": 300000
  }
}

Параметр	По умолчанию	Описание
`videoBridgeEnabled`	`false`	Главный переключатель. Должен быть явно включён.
`videoBridgeModel`	`"grok-imagine-video"`	Id видеомодели xAI.
`videoMaxRounds`	`2`	Максимум раундов video-gen до принудительного финального ответа.
`videoTimeoutMs`	`300000` (5 min)	Таймаут одного видео, включая polling.

Как это работает

opencodex обнаруживает не-OpenAI маршрутизируемую модель с videoBridgeEnabled: true
В разговор внедряется синтетический function tool video_gen
Когда модель вызывает video_gen, opencodex отправляет job в /videos/generations xAI
Bridge опрашивает статус job каждые 5-15 секунд и отправляет heartbeat-сообщения, чтобы поток не умер
Когда видео готово, оно скачивается в каталог artifacts
Локальный путь к файлу возвращается модели как результат tool

Поддерживаемые параметры

Tool video_gen принимает:

Параметр	Тип	Диапазон	Описание
`prompt`	string	required	Подробный prompt для генерации видео
`duration`	integer	1-15	Длительность видео в секундах
`resolution`	string	`"480p"`, `"720p"`	Разрешение видео
`aspect_ratio`	string	7 ratios	`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`

Ограничения

Только xAI: генерация видео доступна только через API xAI Grok Imagine Video
Асинхронно: генерация видео занимает 30-120 секунд
Платно: генерация видео — платная функция xAI (~$0.05/сек @480p, ~$0.07/сек @720p)
Одно видео на один вызов: каждый вызов video_gen создаёт одно видео
Совместим с Image Bridge: оба моста можно включать одновременно
Приоритет web search: если для хода активен web search sidecar (не-runTurn адаптер), video bridge пропускается — одновременно они не работают. Для диагностики в логах пишется console.warn.
Таймаут покрывает submit + poll: бюджет videoTimeoutMs начинает отсчитываться ещё до отправки job, поэтому submit-вызов (60 с) и последующий polling делят один и тот же дедлайн.