PopNowAPI ドキュメント
リファレンスとヘルプ
本文

変更履歴

PopNow の AI 画像・動画・音声生成 API、リモート MCP サーバー、Webhook、クレジット、およびこのドキュメントのうち開発者に影響する変更を日付順に記録します。

PopNow で書かれたコードに影響する変更を、新しい順に記録しています。作業の必要がない追加も、何が可能になったかがわかるように載せています。日付は UTC です。

対応が必要と書かれていない限り、以下の変更で既存の連携が壊れることはありません。

2026-10-23

対応が必要:API 専用の USD 残高。 API キーによる呼び出し、API キーの MCP、Playground は初期残高 $0 の専用 API USD 残高を使います。ウェブサイトのクレジットと API 資金は相互に移行できず、代わりに使うこともできません。OAuth MCP は引き続きウェブサイトのクレジットを使います。モデルの料金基準は同じです。キーは API keys で作成し、入金と支払いの確認は API billing で行います。表示と会計処理には既存の USD フィールド(costUsd、estimatedCostUsd、maxChargeUsd、availableUsd、heldUsd、totalUsd、totalSpend)を使ってください。見積もりを確定するには、有効期限内に同じリクエストで quoteId と expectedCostUsd: quote.maxChargeUsd を送ります。API の課金と API 残高と返金を参照してください。以下の過去の項目は、その日付の動作を説明しています。以前の共通クレジット制や整数クレジットへの丸めも、当時の情報です。

対応が必要:保存したレシピの USD 承認。 API キーによる REST・MCP のレシピとワークフローの実行は、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 で支払います。チャットモデルには、ベース URL、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: ノードパックは Comfy Registry の popnow-comfyui です。ComfyUI Manager から、または comfy node install popnow-comfyui でインストールできます。単一ファイルのノードも引き続き使えます。どちらか一方を使ってください。
  • n8n: コミュニティノード n8n-nodes-popnow は npm にあります。セルフホストの n8n では Settings > Community Nodes からインストールできます。まだ検証済みのノードではないため、n8n Cloud では引き続き HTTP Request のワークフローを使ってください。
  • 新たに追加: popnow-proxy(npm install @popnow/proxy)は、ブラウザやモバイルアプリが API を呼び出す際に、API キーをお使いのサーバーに残したままにします。popnow-bot は、自分で動かす Telegram と Discord のボットです。MCP の stdio ブリッジは 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 には、対応する 5 つのツールが加わりました。list_my_recipes、run_my_recipe、get_recipe_run、list_my_skills、use_my_skill です。いずれも、あなたとあなたのチームだけに公開されます。保存したレシピ、ワークフロー、スキルを参照してください。開発者コンソールには、新しい「レシピとスキル」ページができ、各項目の ID と、すぐに実行できるコードが表示されます。

2026-10-19

対応が必要:1 クレジットは $0.001 になり、料金も下がりました。 1 クレジットはこれまで $0.01 の価値でしたが、現在は $0.001 です。すべての残高、料金、クレジット額は、米ドルでの価値は同じまま、以前の数値の 10 倍になっています。同時に、すべてのモデルの料金が約 3 分の 1 下がったため、同じリクエストでも支払う米ドルは以前より少なくなりました。

  • 残高は換算されました。 失われたものはありません。500 クレジット($5)の残高は、5,000 クレジット($5)になっています。キーの利用上限も、米ドルの額は同じで、新しいクレジットの数値で表示されます。
  • API のフィールド。 credits、maxCredits、expectedCredits、estimatedCredits、availableCredits、heldCredits、totalCredits、そして GET /api/v1/models の credits の料金は、すべて新しい単位です。米ドルの文字列(cost、maxCharge、estimatedCost、available …)は、これまでと同じ意味です。コードでクレジットを 100 で割って米ドルにしている場合は、代わりに 1,000 で割ってください。クレジットの閾値や予算を保存している場合は、10 倍してください。
  • 古い見積もり。 変更前の quoteId と expectedCredits はもう一致しません。createTask は 40901(料金が変わった)を返し、何も確保しません。もう一度見積もりを取り、新しい料金を表示してください。
  • 端数の処理。 タスクは引き続き整数のクレジットに切り上げて課金されますが、1 クレジットは 0.1 セントになったため、端数の影響は 10 分の 1 に小さくなりました。
  • MCP。 300 クレジットまでのジョブはすぐに開始されます。それより大きいジョブは、引き続きユーザーの承諾を待ちます。ChatGPT と Claude で PopNow を使うを参照してください。
  • クレジットパック。 パックは 9,000 クレジットの $9 からで、大きいパックにはボーナスクレジットが付きます。また、$10 から $2,000 の範囲で金額を指定して、1 ドルあたり 1,000 クレジットで購入できるようになりました。料金ページとクレジットと返金を参照してください。

オープンソースの SDK とツール。 PopNow の開発者向けコードが、github.com/popnow-ai で公開されました。MIT ライセンスです。Python と JavaScript および TypeScript の SDK、CLI、Go と PHP のクライアント、MCP の設定ガイド、Agent Skills、例付きの OpenAPI ファイル、そして Blender アドオン、ComfyUI ノードパック、n8n コミュニティノードのソースです。

  • これらはまだ、npm、PyPI、Packagist、ComfyUI Registry のいずれにもありません。新しい SDK、CLI、オープンソースツールページに示したとおり、GitHub からインストールしてください。
  • クイックスタートには、Python と JavaScript の SDK の例を、素の HTTP の例と並べて載せました。HTTP の例はそのままです。

2026-10-17

リモート MCP サーバー。 PopNow は https://api.popnow.ai/mcp で MCP サーバーを動かすようになりました。ChatGPT や Claude に追加すれば、チャットの中で画像、動画、楽曲、ナレーションを作れます。開発者は Cursor、VS Code、Claude Code、または独自の MCP クライアントに追加できます。ツールは 12 個。サインインは OAuth 2.1、または sk-popnow- の API キーを使います。クレジットと料金は、ほかのすべてと同じです。30 クレジットまでのジョブ(2026-10-19 からは 300 クレジットまで)はすぐに開始されます。それより大きいジョブは、ユーザーの確認を待ちます。ChatGPT と Claude で PopNow を使うを参照してください。

  • 接続は Account settings → Devices → Connected AI apps で確認・削除できます。
  • API キーで行った呼び出しは、そのキーの利用上限に計上され、コンソールのログに表示されます。
  • 動画エフェクト(Zombie Turn、Flying Car、そのほかエフェクトページにあるもの)は、apply_effect を通じてチャットアプリから使えます。REST エンドポイントではありません。

新しいドキュメント。 クレジットと返金、n8n、ComfyUI、Blender アドオンの連携ガイド、レシピ、そしてこの変更履歴です。Webhookには、コンソールでアカウントのエンドポイントを管理する節が加わりました。

クレジットパックの返金ルール。 クレジットパックは、購入から 7 日以内(EU と英国の消費者は 14 日以内)で、そのクレジットが 1 つも使われていなければ返金できます。失敗した生成は引き続き自動で返金されます。無料の特典クレジットはパックのクレジットより先に使われ、パックは古いものから順に使われます。詳細は クレジットと返金を参照してください。

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、2026-10-19 以降は $0.001)。credits、maxCredits、expectedCredits、availableCredits などのクレジットのフィールドは、米ドルの文字列と並んで表示されます。クレジットのフィールドを使ってください。
  • モデル ID は <maker>/<model>/<task> の形式です。例:google/nano-banana-2.1/text-to-image。PopNow 自身のツールは、maker に popnow を使います。
  • popnow:// の参照:アップロードには popnow://f/…、アセットライブラリの項目には popnow://a/… を使えます。どのメディアのフィールドでも使えます。メディアを参照してください。
  • チャットとテキストのモデルは、公開 API に含まれていません。 API は画像、動画、音声の生成を対象としています。

Webhook のペイロード バージョン 2。 新しいタスクのコールバックは X-Webhook-Payload-Version: 2 とともに送られ、本文は recordInfo と一致します。Webhookを参照してください。

開発者コンソール。 アカウント単位の Webhook エンドポイント(Standard Webhooks の署名。アカウントあたり最大 16 件。エンドポイントごとにシークレットあり)、手動で再送できる配信ログ、すべてのモデルの API ページでの Playground 実行、ログでのキーによる絞り込み、利用状況の CSV エクスポートを追加しました。

送信時のコンテンツチェック。 プロンプトと入力画像は、タスクが受け付けられる前にチェックされます。断られたリクエストは 400 と data.reason を返し、何も確保せず、料金もかかりません。モデル自体が断ったリクエストは、引き続き content_rejected で失敗し、料金はかかりません。

エラーメッセージを中国語で。 msg と errorMessage は、すでに対応していた 10 言語に加えて、zh-CN と zh-TW でも Accept-Language に従うようになりました。コードは変わりません。エラーを参照してください。

/v1 の OpenAI 互換の動画ルート も、キーを x-api-key ヘッダーで受け付けるようになりました。OpenAI Videosを参照してください。

Blender アドオン 0.1.0。 Blender 4.2 以降で、API キーを使ってクレイのシーンからレンダリング、アニメーション、テクスチャ生成ができます。Blender アドオンを参照してください。

2026-10-15

アセットライブラリ:キャラクター。 キャラクター(ウェブサイトで並べた、名前付きの参照画像のセット)はアセットライブラリに保存され、GET /api/v1/assets/entities で読み取れます。各画像には、生成リクエストで使える固有の popnow://a/… URI があります。キャラクターの作成と編集はウェブサイトで行い、API は読み取りだけを行います。アセットを参照してください。

このページの内容