Видео из изображенияготовится

Генерация короткого видео из одного стартового кадра. Вы передаёте картинку (первый кадр) и текстовое описание движения — что должно произойти в кадре: как двигается камера, объект, свет. Модель достраивает ролик от этого кадра.

Задача считается долгой: ответ приходит не сразу. Планируется асинхронная схема — вы создаёте задачу, получаете идентификатор, затем опрашиваете её статус и в конце забираете ссылку на файл.

Базовый адрес тот же: https://api.librachat.kz/v1. Авторизация тем же ключом: заголовок Authorization: Bearer sk-libra-… . Тело — JSON или multipart/form-data, если стартовый кадр отправляется файлом.

curl https://api.librachat.kz/v1/videos \
  -H "Authorization: Bearer sk-libra-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-video",
    "prompt": "камера медленно наезжает, ветер шевелит траву",
    "image": "data:image/png;base64,iVBORw0KGgo…",
    "size": "1280x720",
    "seconds": 5
  }'

Планируемые ограничения: длительность от 1 до 10 секунд; стартовый кадр — PNG или JPEG, до 10 МБ, соотношение сторон приводится к выбранному разрешению; одновременно на аккаунт — не больше 2 задач в работе. Общий лимит на ключ (120 запросов в минуту) действует и здесь, он считает обращения, а не секунды видео.

Создание задачи отвечает сразу, со статусом queued. Дальше вы опрашиваете GET /v1/videos/{id} раз в несколько секунд, пока статус не станет completed или failed.

{
  "id": "video_01H…",
  "object": "video",
  "model": "libra-video",
  "status": "completed",
  "created_at": 1765000000,
  "size": "1280x720",
  "seconds": 5,
  "output": {
    "url": "https://…/video_01H….mp4",
    "expires_at": 1765086400
  },
  "cost": {
    "currency": "RUB",
    "amount": 191.70
  }
}

Ошибки планируются в том же виде, что и в текстовой части: 401 no_api_key и invalid_api_key, 402 insufficient_balance, 429 rate_limited, 502 upstream_error. Тексты русские, Content-Type: application/json; charset=utf-8.

Видео тарифицируется посекундно, плюс отдельно оплачивается стартовый кадр — он считается изображением на входе.

Пример: ролик 5 секунд в 720p — 5 × 37,80 = 189 ₽, плюс 2,70 ₽ за кадр, итого 191,70 ₽. Тот же ролик в 480p — 5 × 21,60 + 2,70 = 110,70 ₽. Неудачная задача (status: failed) не оплачивается.

Важно: сейчас баланс аккаунта ведётся в токенах и списывается из поля usage в ответе модели. Посекундной и поштучной тарификации в биллинге ещё нет — её нужно сделать отдельно, вместе с пересчётом рублей в токены по курсу пополнения (450 ₽ за 1 млн токенов).