Skip to main content
POST
Песочница
Введите свой API key и промпт, затем отправьте запрос. Это обращается к рабочему API — к тому же эндпоинту, который вызывал бы ваш код, и это единственный способ обратиться к видеомоделям.
Запросы, отправленные с этой страницы, являются реальными и тарифицируются по вашему ключу. Видео тарифицируется за секунду: клип 480p продолжительностью одну секунду стоит от $0.05 до $0.08, а клип 1080p продолжительностью пятнадцать секунд стоит несколько долларов. Начните с небольшой длительности.

Параметры

string
обязательно
Модель для запуска. Принимает grok-imagine-video или grok-imagine-video-1.5, с точным совпадением. Только grok-imagine-video может редактировать или расширять существующий клип; только grok-imagine-video-1.5 обеспечивает доступ к 1080p и предустановленным голосам.
object
обязательно
Параметры генерации. Любой ключ, не указанный ниже, отклоняется с invalid_params.
string
URL https, на который методом POST отправляется завершённая задача, чтобы можно было отказаться от опроса. Поскольку обработка видео занимает от 20 до 50 секунд, стоит настроить обратный вызов.

Что возвращается

После отправки запрос возвращается немедленно — значительно меньше чем за секунду. Клип не входит в этот ответ: генерация выполняется в фоновом режиме.

Затем опрашивайте результат

Эта песочница охватывает только вызов создания. Возьмите id из приведённого выше ответа и проверяйте задачу, пока status не достигнет completed или failed — в зависимости от длительности и разрешения это обычно занимает от 20 до 50 секунд.
Завершённая задача содержит массив outputs с одним файлом MP4:
Файл предоставляется как video/mp4 и воспроизводится встроенно. Его длительность примерно на 0,04 секунды больше запрошенной.
URL-адреса вывода не требуют аутентификации и становятся недействительными через 24 часа после завершения задачи. usage.cost_in_usd_ticks — это публичная цена; ваш баланс изменяется на эту сумму, умноженную на коэффициент тарифа вашей группы — см. тарификацию.

Следующие шаги

Обзор

Режимы, уровни продолжительности и разрешения, референсные изображения, голоса и цены.

API асинхронных задач

Цикл опроса, обратные вызовы и полная таблица ошибок.