SDK、ライブラリ、ツール

Python、JavaScript、Go、PHP、Java の公式クライアント、CLI、AI エージェント向けの MCP サーバー、普段のツール向けのプラグインを提供しています。すべてオープンソースです。

クイックスタート

クライアントをインストールし、POPNOW_API_KEY を設定して、最初の画像を生成してください。

インストール
pip install popnow
export POPNOW_API_KEY="sk-popnow-..."
画像を生成
from popnow import PopNow

client = PopNow()  # reads POPNOW_API_KEY

task = client.images.generate(
    model="google/nano-banana-2.1/text-to-image",
    prompt="A small red fox curled up in a teacup, soft morning light",
)
print(task.state, task.urls[0])
client.files.download(task.assets[0], "fox.png")

認証

キーは Bearer トークンとして送信します。キーは sk-popnow- で始まり、使えるモデルや IP アドレスを制限できます。また、1日・1か月・累計の利用上限も設定できます。

API キー
cURL
curl https://api.popnow.ai/api/v1/models \
  -H "Authorization: Bearer $POPNOW_API_KEY"

すべてのライブラリとツール

すべて github.com/popnow-ai の GitHub にあります。

言語

  • popnow-python

    同期・非同期クライアント、ファイルアップロード、Webhook の検証に対応した Python SDK。

    pip install popnowGitHubPyPI
  • popnow-js

    Node.js、Deno、Bun、Cloudflare Workers、エッジランタイム向けの JavaScript・TypeScript SDK。

    npm install popnowGitHubnpm
  • popnow-go

    型付きリクエスト、待機ヘルパー、イテレーターを備えた Go クライアント。

    go get github.com/popnow-ai/popnow-goGitHubpkg.go.dev
  • popnow-php

    PHP 8.1 以降向けの PHP クライアント。

    composer require popnow/popnowGitHubPackagist
  • popnow-java

    Java 17 以降、Kotlin などの JVM 言語向けの Java クライアント。

    GitHubMaven Central
  • popnow-cli

    コマンドラインツール。ターミナルや CI から、見積もり・作成・待機・アップロード・ダウンロードができます。

    npm install -g @popnow/cliGitHubnpm

ツールとプラグイン

  • popnow-mcp

    リモート MCP サーバーのセットアップガイドとクライアント設定。

    GitHub
  • popnow-skills

    Claude Code、Codex などのコーディングエージェント向けの Agent Skills。

    GitHub
  • popnow-api

    curl、Python、Node.js の例と n8n ワークフローを含む OpenAPI ファイル。

    GitHub
  • popnow-blender

    Blender アドオンのソースコード。

    GitHub
  • popnow-comfyui

    ComfyUI のカスタムノード。グラフの中で PopNow のモデルを実行できます。

    GitHubComfy Registry
  • n8n-nodes-popnow

    セルフホスト版 n8n 向けのコミュニティノード。

    GitHubnpm
  • popnow-proxy

    サーバー側のプロキシ。キーを公開せずに、ブラウザやモバイルアプリから API を呼び出せます。

    npm install @popnow/proxyGitHubnpm
  • popnow-bot

    画像・動画・映像エフェクトを生成するセルフホスト型の Telegram・Discord ボット。利用上限の設定に対応しています。

    GitHubDocker Hub

AI エージェントとコーディングアシスタント向け

本番運用に必要な機能を標準搭載

  • 見積もり

    実行せずにリクエストの料金を見積もり、その見積もりを渡してタスクを作成できます。

    POST /jobs/quote
  • 冪等性キー

    安全に再試行できます。同じキーを使えば、二重に課金されず元のタスクが返ります。

    Idempotency-Key
  • 署名付き Webhook

    完了したタスクをあなたのサーバーに送信します。署名付きなので、送信元が PopNow であることを検証できます。

    X-Webhook-Signature
  • レート制限

    アカウントごとに10秒あたり最大1,000リクエスト。429 が返ったら、待つべき時間がレスポンスに示されます。

    429 · Retry-After

数分で開発を始められます

キーひとつで全モデルを利用でき、必要なときに米ドル残高へチャージ。実行前には毎回正確な料金を確認できます。