PopNowДокументация API
Справочник и помощь
Основное содержимое

Журнал изменений

Датированные изменения API генерации изображений, видео и аудио PopNow, удалённого MCP-сервера, вебхуков, кредитов и этой документации, которые затрагивают разработчиков.

Изменения, которые затрагивают код, написанный под PopNow, от новых к старым. Перечислены и дополнения, которые не требуют действий, чтобы было видно, что стало возможным. Даты указаны в UTC.

Ничто ниже не ломает существующую интеграцию, если там не написано Требуется действие.

2026-10-23

Требуется действие: отдельный баланс API в USD. Вызовы с API-ключом, MCP с API-ключом и Playground расходуют отдельный баланс API в USD, начальное значение — $0. Переводить средства между ним и кредитами сайта или использовать один вместо другого нельзя. OAuth MCP по-прежнему расходует кредиты сайта. Цена одной модели с одинаковыми настройками остаётся прежней. Создавайте ключи в разделе API-ключи; пополняйте API и просматривайте платежи в разделе Оплата API. Для показа сумм и учёта используйте существующие поля USD (costUsd, estimatedCostUsd, maxChargeUsd, availableUsd, heldUsd, totalUsd, totalSpend). Подтверждайте котировки существующими полями USD: отправьте quoteId и expectedCostUsd: quote.maxChargeUsd с тем же запросом до истечения котировки. См. Оплата API и Баланс API и возвраты. Более ранние записи ниже описывают поведение на соответствующие даты, включая прежний общий баланс кредитов и округление до целых кредитов.

Требуется действие: подтверждение USD для сохранённых рецептов. Запуски рецептов и воркфлоу через REST и MCP с API-ключом теперь используют котировки в USD: запросите котировку, затем подтвердите те же входные данные с currency: "USD", десятичной строкой max_usd и quote_id. Старые лимиты в кредитах отклоняются. Читайте и возобновляйте запуск с его исходным ключом. Новый эндпоинт возобновления и инструмент resume_recipe_run позволяют запросить котировку и подтвердить бюджет всего запуска, включая уже потраченные средства и обязательства по выполняющимся задачам. Котировка с unpriced_steps охватывает только шаги с уже рассчитанной ценой; последующие шаги ждут новой котировки и подтверждения. Запуски рецептов через OAuth MCP по-прежнему используют кредиты сайта. См. Рецепты и навыки.

Чат-модели в документации. Claude, Gemini, DeepSeek, GLM, Grok и Kimi можно вызывать с тем же API-ключом через OpenAI Chat Completions и Responses (https://api.popnow.ai/v1), Anthropic Messages и Gemini generateContent; цена считается за токен в USD. В Чат-моделях есть базовые адреса, примеры для SDK, потоковая передача, цены за токен и то, как списывается запрос; в справочнике API перечислены маршруты, а также эндпоинты рецептов, навыков и агентских навыков, которых в нём раньше не было.

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

2026-10-22

SDK и интеграции в реестрах пакетов. Официальные пакеты с открытым кодом больше не нужно устанавливать из GitHub:

  • Python: pip install popnow (PyPI). JavaScript и TypeScript: npm install popnow (npm, также на JSR). CLI: npm install -g @popnow/cli.
  • PHP: composer require popnow/popnow (Packagist). Go: go get github.com/popnow-ai/popnow-go. Новинка: клиент для Java, ai.popnow:popnow-java в Maven Central.
  • ComfyUI: пакет узлов — это popnow-comfyui в Comfy Registry. Установите его из ComfyUI Manager или командой comfy node install popnow-comfyui. Узел из одного файла по-прежнему работает; используйте что-то одно.
  • n8n: community-узел n8n-nodes-popnow опубликован в npm. В self-hosted n8n установите его через Settings > Community Nodes. Он пока не прошёл верификацию, поэтому n8n Cloud по-прежнему использует воркфлоу на HTTP Request.
  • Также новое: popnow-proxy (npm install @popnow/proxy) хранит ваш API-ключ на вашем сервере, когда браузерное или мобильное приложение вызывает API, а popnow-bot — это бот для Telegram и Discord, который вы запускаете сами. Мост stdio для MCP запускается командой npx -y @popnow/mcp.

Если вы устанавливали из GitHub раньше, можно перейти на пакет из реестра: импорты остаются прежними. Все команды есть на странице SDK, CLI и инструменты с открытым кодом.

2026-10-21

Запускайте сохранённые рецепты, воркфлоу и навыки. Рецепты, сохранённые в Studio, воркфлоу, сохранённые с холста, и навыки Poppie теперь можно получить списком и запустить через API: GET /api/v1/recipes, POST /api/v1/recipes/{id}/run (с maxCredits, чтобы ограничить цену) и GET /api/v1/recipes/runs/{runId}, а также GET /api/v1/skills. В MCP добавилось пять одноимённых инструментов: list_my_recipes, run_my_recipe, get_recipe_run, list_my_skills и use_my_skill. Всё остаётся доступным только вам и вашим командам. См. Ваши рецепты, воркфлоу и навыки; в консоли разработчика появилась новая страница Recipes & skills с ID каждого элемента и готовым к запуску кодом.

2026-10-19

Требуется действие: 1 кредит теперь стоит 0,001 $, и цены ниже. Раньше кредит стоил 0,01 $; теперь он стоит 0,001 $. Каждый баланс, цена и сумма в кредитах в 10 раз больше прежнего числа при той же стоимости в долларах США. Одновременно цены всех моделей снизились примерно на треть, поэтому тот же запрос теперь стоит меньше долларов, чем раньше.

  • Баланс пересчитан. Ничего не потеряно: баланс 500 кредитов (5 $) стал 5 000 кредитов (5 $). Лимиты расходов на ваших ключах сохраняют прежнюю сумму в долларах и показывают новые числа в кредитах.
  • Поля API. credits, maxCredits, expectedCredits, estimatedCredits, availableCredits, heldCredits, totalCredits и цены credits в GET /api/v1/models теперь все в новой единице. Строки в долларах США (cost, maxCharge, estimatedCost, available …) означают то же, что и раньше. Если ваш код переводит кредиты в доллары делением на 100, делите на 1 000; если он хранит пороги или бюджеты в кредитах, умножьте их на 10.
  • Старые котировки. quoteId и expectedCredits, полученные до изменения, больше не совпадают. createTask отвечает 40901 (цена изменилась) и ничего не резервирует; запросите котировку заново и покажите новую цену.
  • Округление. Задача по-прежнему списывается в целых кредитах с округлением вверх, но целый кредит теперь равен одной десятой цента, поэтому округление в десять раз мельче.
  • MCP. Задачи до 300 кредитов запускаются сразу; более крупные по-прежнему ждут согласия пользователя. См. PopNow в ChatGPT и Claude.
  • Пакеты кредитов. Пакеты начинаются с 9 $ за 9 000 кредитов, в более крупных есть бонусные кредиты, а теперь можно купить произвольную сумму от 10 до 2 000 $ по 1 000 кредитов за 1 $. См. страницу цен и Кредиты, цены и возвраты.

SDK и инструменты с открытым кодом. Код для разработчиков PopNow теперь открыт под github.com/popnow-ai по лицензии MIT: SDK для Python и JavaScript и TypeScript, CLI, клиенты для Go и PHP, руководство по настройке MCP, Agent Skills, файл OpenAPI с примерами, а также исходный код плагина для Blender, пакета узлов ComfyUI и community-узла n8n.

  • Пока ни один из них не опубликован в npm, PyPI, Packagist или Comfy Registry. Устанавливайте из GitHub, как показано на новой странице SDK, CLI и инструменты с открытым кодом.
  • Быстрый старт показывает SDK для Python и JavaScript рядом с примерами на чистом HTTP, которые остаются без изменений.

2026-10-17

Удалённый MCP-сервер. PopNow теперь работает MCP-сервер по адресу https://api.popnow.ai/mcp. Пользователи могут добавить его в ChatGPT или Claude и создавать изображения, видео, песни и озвучку прямо в чате; разработчики могут подключить его к Cursor, VS Code, Claude Code или собственному MCP-клиенту. Двенадцать инструментов, вход по OAuth 2.1 или API-ключ sk-popnow-, те же кредиты и цены, что и везде. Задачи до 30 кредитов (до 300 с 2026-10-19) запускаются сразу; более крупные ждут подтверждения пользователя. См. PopNow в ChatGPT и Claude.

  • Подключения можно просмотреть и удалить в Account settings → Devices → Connected AI apps.
  • Вызовы с API-ключом учитываются в лимитах расходов этого ключа и появляются в журналах консоли.
  • Видеоэффекты (Zombie Turn, Flying Car и остальные со страницы Effects) доступны чат-приложениям через apply_effect. Это не REST-эндпоинты.

Новые документы. Кредиты, цены и возвраты, руководства по интеграции с n8n, ComfyUI и плагином для Blender, Рецепты и этот журнал изменений. В Вебхуках появился раздел об управлении эндпоинтами аккаунта в консоли.

Правила возврата пакетов кредитов. Пакет кредитов можно вернуть в течение 7 дней после покупки (14 дней для потребителей в ЕС и Великобритании), если ни один его кредит не использован; неудачные генерации по-прежнему возвращаются автоматически. Бесплатные награды тратятся раньше кредитов из пакетов, а пакеты — от самого старого к самому новому. Подробнее: Кредиты, цены и возвраты.

Страницы интеграций на popnow.ai. Страницы n8n, ComfyUI и Рецепты теперь показывают реальные результаты рядом с кодом, который они генерируют.

2026-10-16

Открылся PopNow API. Один REST API для генерации изображений, видео и аудио по адресу https://api.popnow.ai/api/v1. Документация здесь, на popnow.ai/docs, доступна на 12 языках; для инструментов и агентов есть файл OpenAPI и llms.txt.

  • Ключи начинаются с sk-popnow-. Ключи, созданные до смены префикса, продолжают работать; ротировать ничего не нужно.
  • Суммы указаны в кредитах (1 кредит = 0,01 $ при запуске, 0,001 $ с 2026-10-19): credits, maxCredits, expectedCredits, availableCredits и другие поля в кредитах стоят рядом со строками в долларах США. Используйте поля в кредитах.
  • ID моделей имеют вид <maker>/<model>/<task>, например google/nano-banana-2.1/text-to-image. Собственные инструменты PopNow используют popnow в качестве производителя.
  • Ссылки popnow:// для загрузок (popnow://f/…) и элементов библиотеки ассетов (popnow://a/…) работают в любом медиа-поле. См. Медиа.
  • Чат- и текстовые модели не входят в публичный API. API охватывает генерацию изображений, видео и аудио.

Версия 2 тела вебхука. Новые обратные вызовы задач отправляются с X-Webhook-Payload-Version: 2; тело совпадает с recordInfo. См. Вебхуки.

Консоль разработчика. Эндпоинты вебхуков уровня аккаунта (подписи Standard Webhooks, до 16 на аккаунт, свой секрет у каждого эндпоинта), журнал доставок с ручной повторной отправкой, запуски Playground на странице API каждой модели, фильтры по ключам в журналах и экспорт использования в CSV.

Проверка содержимого при отправке. Промпты и входные изображения проверяются до того, как задача принимается. Отклонённый запрос возвращает 400 с data.reason, ничего не резервирует и ничего не стоит. Запросы, которые сама модель отклоняет, по-прежнему завершаются с ошибкой content_rejected без оплаты.

Сообщения об ошибках на китайском языке. msg и errorMessage теперь следуют Accept-Language и для zh-CN, и для zh-TW, наряду с уже поддерживаемыми десятью языками. Коды не изменились. См. Ошибки.

Маршруты видео, совместимые с OpenAI, под /v1 также принимают ключ в заголовке x-api-key. См. Совместимость с OpenAI Videos.

Плагин для Blender 0.1.0. Рендер, анимация и текстуры из глиняной сцены в Blender 4.2 или новее с вашим API-ключом. См. Плагин для Blender.

2026-10-15

Библиотека ассетов: персонажи. Персонажи (именованный набор референсных изображений, собранный на сайте) хранятся в библиотеке ассетов и читаются через GET /api/v1/assets/entities; у каждого изображения есть собственный URI popnow://a/… для запросов генерации. Персонажи создаются и редактируются на сайте, API только читает их. См. Ассеты.

На этой странице