Модели

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

Как устроен ID модели

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker — кто создал модель. Инструменты самого PopNow обозначаются popnow.
• model сохраняет точки в версии: seedance-2.0, а не seedance-2-0.
• task — что делает вызов: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio и так далее. Редактирование изображений всегда называется edit.

У семейства моделей обычно несколько ID — по одному на задачу. Выбирайте тот, что подходит к отправляемым данным: .../text-to-video принимает только промпт, .../image-to-video требует стартовое изображение.

Чтение каталога из кода

Источник истины — живой каталог: в нём видно, что доступно прямо сейчас, и цены, действующие для вашего аккаунта.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Фильтры списка: modality (image, video, audio), provider, task, search, а также includeSchema=1 и includeExamples=1, чтобы получить схемы входных данных и проверенные примеры. Если ваш HTTP-клиент считает параметр пути одним сегментом, кодируйте слэши как %2F.

Полезные поля

Как читать цены

credits — та же цена, что показывает popnow.ai, в кредитах (1 кредит = 0,01 $):

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit говорит, как растёт цена (per_image, per_second, per_request, per_1k_characters), perUnit — стартовая цена, а каждое правило срабатывает, когда запрос совпадает со значениями when (* обозначает настройку, определяющую уровень, здесь это resolution). Итоговое списание за задачу округляется вверх до целых кредитов.

Точную сумму для конкретного запроса узнайте через jobs/quote с тем же телом, что вы отправили бы в createTask.

Схемы входных данных

inputSchema — стандартная JSON Schema (draft 2020-12). Для всех моделей действует несколько правил:

• Неизвестные поля отклоняются. Опечатка вроде aspect_ration даёт 400, а не тихо игнорируется.
• Имена полей общие для всех моделей. Одно и то же понятие всегда называется одинаково: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Значения по умолчанию подставляются сами. Отправляйте только то, что хотите изменить.
• Поля с медиа принимают публичную HTTPS-ссылку, загруженный вами файл popnow:// или сохранённый ассет. См. Медиа.
• Подсказки для интерфейса лежат в объекте x-ui у каждого свойства (подписи, порядок, шаг ползунков). На проверку они не влияют; незнакомые ключи игнорируйте.

Если у модели есть seed, а вы его не указали, выбирается случайное значение и возвращается в input задачи — так можно повторить понравившийся результат.

Кэширование

Ответы каталога относятся только к вашему аккаунту, их можно кэшировать на 60 секунд. Разумный подход: держать список в кэше несколько минут, перечитывать модель при смене её version, а available: false понимать как «попробуйте позже или выберите другую модель».

Все доступные модели

Указана самая низкая цена за единицу; более высокое разрешение, длинные ролики и дополнительные опции стоят дороже. На странице каждой модели перечислены все уровни.