Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "Золотистый ретривер бежит по зеленому полю в солнечную погоду",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
{
  "id": "video_abc123def456",
  "object": "generation.task",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Модель генерации видео Grok Video
  • Выбор модели grok-video-3 через параметр model
  • Поддержка генерации видео из текста и из изображений
  • Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 в image_urls. Пожалуйста, сначала загрузите изображения через API загрузки изображений, а затем вызовите данный API с полученным URL.

Авторизация

Authorization
string
обязательно
Все API-запросы требуют аутентификации с помощью Bearer TokenПолучение API Key: Перейдите на страницу управления API Key для получения вашего API KeyДобавьте в заголовки запроса:
Authorization: Bearer YOUR_API_KEY

Тело запроса

model
string
по умолчанию:"grok-video-3"
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • grok-video-3 - Модель генерации видео Grok
Пример: "grok-video-3"
prompt
string
обязательно
Текстовое описание для генерации видео
duration
integer
Продолжительность видео (в секундах)Пример: 5 или 10
aspect_ratio
string
Соотношение сторон видеоПоддерживаемые форматы:
  • 16:9 (горизонтальное)
  • 9:16 (вертикальное)
image_urls
string[]
Массив URL-адресов изображений для генерации видео из изображений⚠️ Поддерживается только формат URL (base64 больше не поддерживается)
  • Общедоступные URL-адреса изображений (http:// или https://)
  • Используйте API загрузки изображений для загрузки локальных изображений

Ответ

id
string
Уникальный идентификатор задачи для запроса статуса
object
string
Тип объекта, всегда generation.task
model
string
Название используемой модели
status
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
progress
integer
Прогресс задачи в процентах (0-100)
created_at
integer
Временная метка создания задачи (Unix timestamp)
metadata
object
Метаданные задачи
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "Золотистый ретривер бежит по зеленому полю в солнечную погоду",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
{
  "id": "video_abc123def456",
  "object": "generation.task",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}