Grok Video 2
Создание видео по текстовому описанию или с изображениями-референсами.
Стоимость
3 ₽ за секунду (3 токена). Стоимость резервируется при создании и списывается только после успеха; при ошибке резерв освобождается.
| Длительность | Стоимость |
|---|---|
| 5 секунд | 15 ₽ |
| 10 секунд | 30 ₽ |
| 15 секунд | 45 ₽ |
Параметры создания
| Поле | Обязательное | Значения |
|---|---|---|
model | Да | grok-video-2 |
duration | Да | Число: 5, 10 или 15. Длительность 20/25 секунд не поддерживается. |
quality | Нет | 720p — единственное значение и значение по умолчанию. |
aspect_ratio | Нет | auto по умолчанию; также 1:1, 2:3, 3:2, 9:16, 16:9. |
prompt | Да | Непустая строка до 3500 символов. |
upload_ids | Нет | До пяти уникальных UUID загруженных изображений. |
1. Загрузите референсы (необязательно)
curl -X POST https://corp.aitale.ru/api/v1/files \ -H "Authorization: Bearer $AITALE_CORP_KEY" \ -F "file=@reference.jpg"
Один запрос — один JPG/PNG/WEBP до 8 МиБ. Добавьте полученные data.id в upload_ids при создании. Без референсов этот шаг пропускается. Base64 и внешние URL не принимаются; загрузки хранятся 12 часов и доступны только своему аккаунту.
2. Создайте задание
curl -X POST https://corp.aitale.ru/api/v1/videos/generations \
-H "Authorization: Bearer $AITALE_CORP_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: unique-video-request-001" \
-d '{"model":"grok-video-2","duration":10,"quality":"720p","aspect_ratio":"16:9","prompt":"Кот гуляет"}'Ответ — HTTP 202 с data.id, object: video_generation, статусом, duration и cost_tokens. Для 10 секунд стоимость — 30.00. Сохраняйте Idempotency-Key при сетевом повторе того же запроса; новое тело требует нового ключа.
3. Дождитесь результата
curl https://corp.aitale.ru/api/v1/videos/generations/GENERATION_ID \ -H "Authorization: Bearer $AITALE_CORP_KEY"
Проверяйте статус с интервалом из Retry-After (обычно 2 секунды), без параллельного polling. Продолжайте при queued/processing; при succeeded скачайте data.result.url. failed, capacity_timeout и expired — терминальные статусы.
4. Скачайте MP4
curl "$RESULT_URL" \ -H "Authorization: Bearer $AITALE_CORP_KEY" \ -o result.mp4
RESULT_URL — URL из ответа. Скачивание требует Bearer-ключ; обычный <video src="…"> его не передаст. Сохраните файл в своей системе и воспроизводите свою копию. Результат API удаляется через 12 часов.
Ожидание и ошибки
При недоступной или занятой мощности задание ожидает до 60 секунд, затем завершается capacity_timeout. Автоматического fallback у корпоративного API нет. Если процент прогресса не увеличивается 30 секунд, генерация завершается по таймауту; пока процент растёт, ожидание продолжается.
Отказ по содержимому — content_policy_violation: измените запрос. Техническая ошибка — generation_failed: используйте собственный fallback. Все ошибки и правила повторов.
Совместимость: ранее выданный идентификатор grok-video-1 продолжает приниматься для существующих интеграций (до четырёх референсов). Для новых интеграций используйте grok-video-2.