Видео (video)готовится

Генерация видео занимает от десятков секунд до нескольких минут — это дольше, чем живёт обычный HTTP-запрос. Поэтому обмен планируется в два шага, асинхронно.

Шаг первый: вы отправляете POST /v1/videos/generations и сразу получаете идентификатор задачи. Ответ приходит быстро, самого видео в нём нет. Шаг второй: вы опрашиваете GET /v1/videos/generations/{id}, пока статус не станет succeeded или failed. Ссылка на готовый файл появляется только в финальном ответе.

Синхронного режима не планируется: даже короткий ролик не помещается в таймаут запроса. Рассчитывайте архитектуру на очередь задач и фоновой опрос, а не на ожидание внутри обработчика.

curl https://api.librachat.kz/v1/videos/generations \
  -H "Authorization: Bearer sk-libra-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-video",
    "prompt": "Кофейная чашка на столе у окна, медленный наезд камеры, утренний свет",
    "resolution": "720p",
    "duration": 6
  }'

{
  "id": "vid_01J8Z…",
  "object": "video.generation",
  "model": "libra-video",
  "status": "queued",
  "created": 1786000000
}

Заголовок авторизации и ключи те же, что для текста: Authorization: Bearer sk-libra-…, до 10 ключей на аккаунт. Отдельного ключа под видео не будет.

curl https://api.librachat.kz/v1/videos/generations/vid_01J8Z… \
  -H "Authorization: Bearer sk-libra-…"

{
  "id": "vid_01J8Z…",
  "object": "video.generation",
  "status": "succeeded",
  "model": "libra-video",
  "resolution": "720p",
  "duration": 6,
  "created": 1786000000,
  "completed": 1786000148,
  "data": [
    {
      "url": "https://…/vid_01J8Z….mp4",
      "format": "mp4",
      "width": 1280,
      "height": 720,
      "expires_at": 1786086548
    }
  ]
}

Рекомендуемая частота опроса — раз в 5 секунд, с постепенным увеличением паузы до 15–30 секунд. Опрос статуса считается обычным запросом и учитывается в лимите 120 запросов в минуту на ключ, поэтому не опрашивайте чаще раза в секунду.

Ссылка на файл планируется временной (порядка суток). Сохраняйте видео к себе сразу после получения, не храните URL в базе как постоянный.

Пример: ролик 6 секунд в 720p со стартовым кадром — 6 × 37,80 + 2,70 = 229,50 ₽. Баланс пополняется от 1 млн токенов по цене 450 ₽ за 1 млн.

Плата планируется за успешно завершённую задачу. Статусы failed и canceled списываться не должны — это нужно подтвердить при реализации.

Проверку баланса планируется делать на этапе создания задачи: стоимость известна заранее из разрешения и длительности, поэтому 402 приходит сразу, а не после нескольких минут ожидания.