SDK, CLI и инструменты с открытым кодом

Всё, что PopNow публикует для разработчиков, открыто и распространяется под лицензией MIT в организации popnow-ai на GitHub. SDK оборачивают тот же REST API, который описан в этих документах, поэтому всё остальное здесь тоже применимо: те же ID моделей, те же поля input, тот же баланс API в USD.

Пакеты опубликованы в PyPI, npm, Packagist, Maven Central и Comfy Registry; устанавливайте их командами с этой страницы. Обычный HTTP тоже работает: все примеры в документации используют curl, fetch или requests.

Обзор

Каждому инструменту нужен API-ключ из API-консоли. Положите его в POPNOW_API_KEY: SDK и CLI читают его оттуда:

export POPNOW_API_KEY="sk-popnow-..."

SDK для Python

popnow-python содержит синхронный клиент (PopNow) и асинхронный (AsyncPopNow), типизированные результаты, автоматические заголовки Idempotency-Key, повторы при 429 и 503, загрузку файлов, библиотеку ассетов и проверку подписи вебхуков. Нужен Python 3.9 или новее; зависит он только от httpx.

pip install popnow

from popnow import PopNow

client = PopNow()  # reads POPNOW_API_KEY

task = client.images.generate(
    model="alibaba/z-image-turbo/text-to-image",
    prompt="A small red fox curled up in a teacup, soft morning light",
)
print(task.state, task.cost, "USD", task.urls[0])

images.generate создаёт задачу, ждёт её завершения и поднимает TaskFailedError, если она не удалась. Низкоуровневые client.jobs.quote(), create(), get() и wait() соответствуют один к одному эндпоинтам задач.

SDK для JavaScript и TypeScript

popnow-js не имеет зависимостей времени выполнения и использует глобальный fetch, поэтому работает на Node.js 18+, Deno, Bun, Cloudflare Workers и других edge-средах. Он поставляется со сборками ESM и CommonJS и с описаниями типов.

npm install popnow

На Deno и Bun он также есть в JSR: deno add jsr:@popnow/popnow или npx jsr add @popnow/popnow.

import { PopNow } from 'popnow';

const popnow = new PopNow(); // reads POPNOW_API_KEY

const task = await popnow.jobs.createAndWait({
  model: 'alibaba/z-image-turbo/text-to-image',
  input: { prompt: 'A small red fox curled up in a teacup, soft morning light' },
});
console.log(task.state, task.output?.assets?.[0]?.url);

createAndWait сам отправляет Idempotency-Key и опрашивает задачу, пока она не завершится. jobs.quote, jobs.create и jobs.wait нужны, когда хочется сначала узнать цену или ждать в другом месте.

Командная строка

popnow-cli устанавливает команду popnow для скриптов, задач CI и быстрых проверок из терминала. Нужен Node.js 22.12 или новее:

npm install -g @popnow/cli
popnow --help

Чтобы запустить однократно без установки: npx @popnow/cli status.

Go и PHP

popnow-go — обычный модуль Go (Go 1.23+):

go get github.com/popnow-ai/popnow-go

popnow-php (PHP 8.1+) — это popnow/popnow в Packagist:

composer require popnow/popnow

Java

popnow-java — клиент для Java 17+, Kotlin и других языков JVM, опубликованный в Maven Central как ai.popnow:popnow-java. Его единственная зависимость — Jackson databind; HTTP работает через встроенный HttpClient из JDK.

<dependency>
  <groupId>ai.popnow</groupId>
  <artifactId>popnow-java</artifactId>
  <version>0.1.0</version>
</dependency>

dependencies {
    implementation("ai.popnow:popnow-java:0.1.0")
}

import ai.popnow.*;
import java.util.Map;
import java.util.UUID;

PopNowClient client = PopNowClient.builder().apiKeyFromEnvironment().build(); // POPNOW_API_KEY

CreateTaskRequest request = CreateTaskRequest.of("alibaba/z-image-turbo/text-to-image",
        Map.of("prompt", "A small red fox curled up in a teacup, soft morning light"));

TaskRecord task = client.run(request, UUID.randomUUID().toString()); // createTask + waitForTerminal
System.out.println(task.state() + " for " + task.cost() + " USD");

run создаёт задачу под переданным вами Idempotency-Key и ждёт, пока она не завершится; createTask и waitForTerminal нужны, когда эти два шага хочется разделить.

MCP и Agent Skills

Для удалённого MCP-сервера пакет не нужен: добавьте https://api.popnow.ai/mcp в ChatGPT, Claude, Cursor, VS Code или Claude Code. popnow-mcp собирает готовые конфиги для каждого клиента и небольшой мост stdio для клиентов, которые умеют запускать только локальные серверы. Мост опубликован в npm как @popnow/mcp, поэтому npx -y @popnow/mcp запускает его без шага установки.

popnow-skills учит агентов для программирования создавать видео, изображения, музыку и озвучку через REST API, а также искать справку по API. В Claude Code:

/plugin marketplace add popnow-ai/popnow-skills
/plugin install popnow@popnow-skills

README описывает Codex, приложения Claude и других агентов.

Примеры и интеграции

• popnow-api содержит файл OpenAPI, готовые примеры на curl, Python и Node.js и воркфлоу n8n для импорта. Если нужен клиент на другом языке, передайте файл OpenAPI генератору кода.
• popnow-blender — исходный код плагина для Blender. Чтобы установить его, скачайте zip с popnow.ai/blender; в репозитории можно собрать тот же zip самостоятельно.
• popnow-comfyui — пакет узлов ComfyUI в Comfy Registry: по одному узлу на модель, а также PopNow Generate и PopNow LoRA. В ComfyUI Manager откройте Custom Nodes Manager, найдите PopNow и нажмите Install, или выполните comfy node install popnow-comfyui. Полные шаги и узел из одного файла, если вы предпочитаете один файл, который можно прочитать за минуту, — на странице ComfyUI.
• n8n-nodes-popnow — community-узел n8n на npm для self-hosted n8n. Откройте Settings > Community Nodes > Install и введите n8n-nodes-popnow, или установите его из терминала и перезапустите n8n. Он пока не прошёл верификацию, поэтому установить его в n8n Cloud нельзя; воркфлоу на HTTP Request не требует установки и тоже работает там.
• popnow-proxy — небольшой серверный маршрут для Next.js, Express и других сред с fetch. Браузерное, мобильное или десктопное приложение обращается к вашему серверу, а прокси добавляет там API-ключ, поэтому ключ никогда не попадает в клиент. Нужен Node.js 22.12 или новее.
• popnow-bot — бот для Telegram и Discord, который вы запускаете сами через Docker: изображения, видео и видеоэффекты прямо в чате, с проверкой цены перед платными запусками и дневными лимитами расходов. Клонируйте репозиторий и запустите его командой docker compose up -d --build или скачайте готовый образ popnow/popnow-bot с Docker Hub.

# n8n community node, from a shell on self-hosted n8n
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install n8n-nodes-popnow

# server-side proxy
npm install @popnow/proxy

Есть ли официальный SDK PopNow?

Да. Python и JavaScript SDK, CLI, а также клиенты для Go, PHP и Java, описанные на этой странице, поддерживаются PopNow и открыты на github.com/popnow-ai.

SDK опубликованы в npm и PyPI?

Да. pip install popnow ставит SDK для Python из PyPI, а npm install popnow — SDK для JavaScript из npm. CLI — это @popnow/cli в npm, клиент PHP — popnow/popnow в Packagist, клиент Java — ai.popnow:popnow-java в Maven Central, а пакет ComfyUI — popnow-comfyui в Comfy Registry. В CHANGELOG.md каждого репозитория перечислены его релизы.

Использовать SDK или вызывать REST API напрямую?

Можно и так, и так. SDK добавляют повторы, ключи идемпотентности, опрос и типизированные результаты. Чистый HTTP ничего не требует для установки, и именно его показывают все примеры в этой документации.

SDK стоят денег?

Нет. Код бесплатен по лицензии MIT; генерации API расходуют отдельный баланс API в USD по той же цене модели, что и на сайте. Пополните его в разделе Оплата API. OAuth MCP использует кредиты сайта, MCP с API-ключом — USD API.

Куда сообщить об ошибке?

Откройте issue в репозитории, к которому относится ошибка. Если это проблема безопасности, следуйте файлу SECURITY.md в этом репозитории, а не открывайте публичный issue.

Связанное