Генерация видео

POST /v1/video/generations — асинхронная генерация видео. Длительность 4–10 секунд, поддерживается text-to-video и image-to-video.

Создание задачи

curl https://api.ranvik.ru/v1/video/generations \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-31",
    "prompt": "Дрон-съёмка горного озера на закате",
    "duration": 5,
    "aspectRatio": "16:9"
  }'

# HTTP 202
# { "id": "task_v123...", "status": "queued", "model": "veo-31", ... }

Опрос статуса

curl 'https://api.ranvik.ru/v1/video/generations?task_id=task_v123...' \
  -H "Authorization: Bearer rk_live_..."

# Когда status = "completed":
# { "id": "task_v123...", "status": "completed",
#   "url": "https://cdn.ranvik.ru/vid/.../xyz.mp4" }

Webhook (рекомендуется)

Чтобы не опрашивать — задайте "webhook_url": "https://your-app.com/hook". На завершение придёт POST с JSON ответа.

Image-to-video

Передайте "image": "https://..." или base64 — модель будет анимировать кадр. Поддерживается всеми моделями.

Хранение

Все результаты живут на CDN 1 сутки. Если нужен долгосрочный архив — скачайте файл по url сразу.

Полный список моделей и параметров — на странице /models (фильтр «video»).