Документация видео API Grok
Видео API Grok — это интерфейс для разработчиков для генерации AI-видео, поддерживающий создание высококачественных видео через текстовые промпты, референс-изображения, управление ключевыми кадрами и другие методы. Через единый шлюз TTAPI вы можете стабильно обращаться к последним моделям Grok (включая grok-imagine-video-1.5-fast, grok-imagine-video-1.5, grok-imagine-video-1.5-lite).Быстрый старт
- Текст в видео — Генерация видео из чистого текста
- Первый кадр в видео — Указание начального кадра видео
- Последний кадр в видео — Указание конечного кадра видео
- Первый и последний кадр в видео — Указание обоих кадров
- Ключевой кадр в видео — Вставка ключевых кадров в середину видео
- Референс в видео — Использование референс-изображений и голосовых ролей
- Fetch API (получение результатов) — Опрос результатов асинхронных задач
- Цены на видео
Основные функции
🎬 AI-генерация видео
Создавайте высококачественные видео из текстовых промптов с помощью последних моделей Grok, с поддержкой различных диапазонов длительности и вариантов разрешения.⚡ Асинхронный рабочий процесс
Отправляйте задачи генерации асинхронно и получайте результаты через опрос или webhook-коллбеки, что подходит для интеграции в производственную среду.🎯 Точное управление ключевыми кадрами
Указывайте изображения ключевых кадров в середине видео через параметрkeyframes, который можно комбинировать с first_frame и last_frame. Каждый запрос поддерживает до 4 ключевых кадров.
️ Блокировка первого/последнего кадра
Строго указывайте начальные и конечные изображения видео черезfirst_frame и last_frame. Когда одно и то же изображение передается в оба параметра, создается эффект цикла.
Референс-изображения и голосовые роли
Передавайте референс-изображения (до 7 штук) черезrefer_images или передавайте голосовые роли через reference_audios для управления характеристиками голоса персонажей в видео.
Различия моделей
Примечания:
grok-imagine-video-1.5-fastиgrok-imagine-video-1.5поддерживают все расширенные функции управленияgrok-imagine-video-1.5-lite— легковесная модель, поддерживает только базовую функциональность преобразования текста в видео
Аутентификация и базовый URL
Полные инструкции по настройке см. в Шлюз и аутентификация.
Пример от начала до конца
Шаг 1 — Отправка запроса на генерацию
Шаг 2 — Сохранение jobId
Шаг 3 — Получение результата генерации
videoUrl и другую полную информацию после завершения задачи.
Все эндпоинты
Типичные рабочие процессы
Почему стоит выбрать TTAPI
- Единый шлюз — Доступ к Grok и другим AI-моделям с одним API Key
- Поддержка последних моделей — Всегда поддержка последних версий Grok
- Стандартизированный асинхронный рабочий процесс — Согласованные паттерны отправки задач, опроса fetch и webhook-коллбеков
- Четкая документация — Разделение обзора и справочника по эндпоинтам
- Единая биллинг — Единое управление квотами для всех AI API
Часто задаваемые вопросы
Какую модель Grok мне использовать?
- grok-imagine-video-1.5-fast: Подходит для сценариев быстрой генерации, требующих расширенного управления (ключевые кадры, первый/последний кадр), поддерживает более длинный входной текст
- grok-imagine-video-1.5: Стандартное качество, баланс скорости и качества, поддерживает все расширенные функции
- grok-imagine-video-1.5-lite: Легковесная, экономичная, поддерживает только базовое преобразование текста в видео
Как управлять первым и последним кадром?
Используйте Первый и последний кадр в видео, передавая параметрыfirst_frame и last_frame. Когда оба установлены на одно и то же изображение, создается эффект цикла.
Как вставить ключевые кадры в середину видео?
Используйте Ключевой кадр в видео, передавая массив ключевых кадров через параметрkeyframes. Каждый ключевой кадр содержит image_url и timestamp_s (временная метка). Каждый запрос поддерживает до 4 ключевых кадров.
Как использовать референс-изображения или голосовые роли?
Используйте Референс в видео, передавая референс-изображения (до 7 штук) черезrefer_images или передавая голосовые роли через reference_audios.
Как проверить статус задачи?
Используйте Fetch API сjobId для опроса статуса. Во время обработки status возвращает ON_QUEUE; после завершения status возвращает SUCCESS с полным URL видео в ответе.
Поддерживает ли видео API Grok Webhook?
Да. ПередайтеhookUrl при отправке любой задачи Grok, и TTAPI выполнит POST результата на ваш эндпоинт после завершения задачи, устраняя необходимость в опросе.