Перейти к содержимому

Генерация видео (асинхронно)

Генерация видео занимает много времени (от десятков секунд до нескольких минут), поэтому 4ALL API использует асинхронный протокол отправка + опрос: сначала отправьте задачу и получите task_id, затем опрашивайте результат.

1. Отправка задачи

POST https://api.4allapi.com/v1/video/generations

curl https://api.4allapi.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "вид с дрона, пролетающий над береговой линией на рассвете, кинематографично, естественный свет",
    "size": "1280x720",
    "seconds": "8"
  }'

Ответ:

{ "task_id": "video-task-xxx", "status": "submitted" }

Параметр	Описание
`model`	Модель видео, например `veo-3.1`, `sora-2`, `kling-v3`, видеомодель `omni-flash`
`prompt`	Описание сцены и движения камеры
`size`	Разрешение (горизонтальное/вертикальное), в пределах, поддерживаемых моделью
`seconds`	Длительность (в секундах), в пределах, поддерживаемых моделью
`image`	Опорное изображение первого кадра для image-to-video (поддерживаемые модели, URL или base64)

2. Проверка результата

GET https://api.4allapi.com/v1/video/generations/{task_id}

curl https://api.4allapi.com/v1/video/generations/video-task-xxx \
  -H "Authorization: Bearer $AIPROXY_KEY"

status будет проходить через submitted → processing → succeeded / failed; при успехе возвращается адрес загрузки видео:

{
  "task_id": "video-task-xxx",
  "status": "succeeded",
  "video_url": "https://.../result.mp4"
}

Рекомендации по опросу

Опрос выполняйте каждые 5–10 секунд; общий тайм-аут увеличивайте в соответствии с длительностью модели (например, до 10 минут);
Статус failed будет содержать причину ошибки; при неудачах из-за нарушения правил контента скорректируйте prompt и отправьте задачу повторно;
Ссылка на видео действует ограниченное время, поэтому после успешной генерации как можно скорее сохраните его в своё хранилище.