API документация

options.resolution: 480p (по умолчанию), 720p или 1080p. Тариф зависит от выбранного качества. Передавайте одинаковое значение при расчёте и создании заказа; после смены качества получите новый расчёт. Без этого параметра сохраняется 480p. Каталожная стартовая цена указана для 480p.

Для моделей с pricing.quote_required=true сначала загрузите файлы, дождитесь готовности и рассчитайте цену. Расчёт бесплатный, действует 10 минут и включает реселлерскую скидку. Затем отправьте те же параметры в POST /orders, добавив quote_id и заголовок Idempotency-Key. Один расчёт создаёт не более одного заказа.

Без файлов - генерация по тексту; одно фото без видео - первый кадр; несколько фото - референсы; с видео - видеореференс. Файлы необязательны. media.image: до 6 фото, media.video: одно видео MP4/MOV длительностью 2-30 секунд. Готовые HEIC/HEIF автоматически конвертируются в PNG.

options.duration: целое число 4-30, по умолчанию 4. С видео не передавайте длительность: она рассчитывается как округлённая вверх длина исходника, минимум 4. Другая явно переданная длительность отклоняется. Фото: 301-5999 px по каждой стороне, соотношение сторон больше 0,4 и меньше 2,5, до 30 MB. Видео: до 200 MB, 24-60 кадров/с, 409600-927408 пикселей в кадре, соотношение сторон 0,4-2,5.

Цена: без видео - секунды результата × тариф; с видео - (округлённые вверх секунды исходника + секунды результата) × тариф. Расчёт учитывает вашу скидку. price_usd из каталога - стартовая цена за 4 секунды без исходного видео, точная сумма находится в quote.price_usd. Запрос без расчёта вернёт price_quote_required; изменённые данные или тариф - price_quote_changed; истёкший расчёт - price_quote_expired. Заказ при этих ошибках не создаётся.

POST /api/v1/orders/quote
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "model_id": 123,
  "prompt": "Animate the photo with a slow camera movement.",
  "media": {"image": ["tmp/your-ready-upload.png"]},
  "options": {"duration": 4, "aspect_ratio": "adaptive", "resolution": "480p"}
}

123 - пример; возьмите актуальный model_id из GET /models. Для генерации отправляйте исходные параметры и quote_id, не весь ответ расчёта.

Обязателен расчёт через POST /orders/quote. Передайте model_id, prompt и необязательные options: duration (целое число 4-30, по умолчанию 4), resolution (480p по умолчанию, 720p или 1080p), aspect_ratio (adaptive, 1:1, 16:9, 9:16, 4:3). Звук включён. Другие параметры не поддерживаются.

Файлы передаются готовыми временными загрузками в media.image (до 6 фото) и media.video (одно видео). Фото: JPG, PNG без прозрачности, WebP, HEIC/HEIF с конвертацией; до 20 МБ, стороны 240-8000 пикселей. Видео: MP4/MOV, 1-15 секунд, до 100 МБ, стороны 240-4096 пикселей. Соотношение сторон исходных файлов: от 1:8 до 8:1.

Без файлов создаётся видео по тексту. Одно фото без видео становится первым кадром; несколько фото или фото с видео используются как референсы. В промпте: Image1, Image2, Video1; обозначения @image1 и [Image1] также нормализуются. Рекомендуется английский промпт.

С видео не передавайте options.duration: длительность результата равна длине исходника, округлённой вверх до целой секунды, но не меньше 4 секунд. Сумма длительностей исходника и результата не превышает 30 секунд. Цена включает каждую начатую секунду исходника и выбранные секунды результата; зависит от качества и учитывает реселлерскую скидку. Каталог показывает цену «от» за 4 секунды в 480p без видео. Точная сумма - quote.price_usd.

Для запуска отправьте те же параметры в POST /orders, добавив quote_id и заголовок Idempotency-Key. Расчёт действует 10 минут, создаёт не более одного заказа и требует обновления при изменении параметров, файлов или скидки. Расчёт не запускает генерацию и не списывает баланс.

Для этой модели теперь обязателен расчёт через POST /orders/quote. Передайте model_id, необязательный prompt и готовые загрузки в media.image и media.video (по одному файлу). Фото обязательно, видео MP4/MOV: 3-30 секунд, до 100 МБ. Ограничения фото смотрите в каталоге модели.

Длительность определяется по видео. Необязательный options.resolution: 720p (по умолчанию) или 1080p. Тариф зависит от выбранного качества. Передавайте одинаковое значение при расчёте и создании заказа; после смены качества получите новый расчёт. Без этого параметра сохраняется 720p. options.duration, mode и character_orientation не принимаются: ориентация задаётся по видео. Цена считается за каждую начатую секунду ролика один раз, без добавления длительности исходника второй раз; учитывается реселлерская скидка. Каталог показывает минимальную цену за 3 секунды в 720p, точная сумма - quote.price_usd.

Затем отправьте те же параметры в POST /orders, добавив quote_id и Idempotency-Key. Расчёт действует 10 минут. Один расчёт создаёт не более одного заказа. Старые запросы без quote_id возвращают price_quote_required без заказа и списания. Изменённый или истёкший расчёт нужно получить заново.