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")npm install popnow
export POPNOW_API_KEY="sk-popnow-..."import { PopNow } from "popnow";
const popnow = new PopNow(); // reads POPNOW_API_KEY
const task = await popnow.jobs.createAndWait({
model: "google/nano-banana-2.1/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);go get github.com/popnow-ai/popnow-go
export POPNOW_API_KEY="sk-popnow-..."package main
import (
"context"
"log"
popnow "github.com/popnow-ai/popnow-go"
)
func main() {
ctx := context.Background()
client, err := popnow.New(popnow.Options{}) // reads POPNOW_API_KEY
if err != nil {
log.Fatal(err)
}
request := popnow.CreateTaskInput{
Model: "google/nano-banana-2.1/text-to-image",
Input: map[string]any{"prompt": "A small red fox curled up in a teacup, soft morning light"},
}
// One idempotency key per piece of work: a resend returns the original task.
task, err := client.CreateTask(ctx, request, "fox-teacup-1", popnow.CreateTaskOptions{})
if err != nil {
log.Fatal(err)
}
final, err := client.WaitForTerminal(ctx, task.TaskID, popnow.WaitOptions{})
if err != nil {
log.Fatal(err)
}
for _, asset := range final.ReadyAssets() {
log.Println(final.State, asset.URL)
}
}composer require popnow/popnow
export POPNOW_API_KEY="sk-popnow-..."<?php
require __DIR__ . '/vendor/autoload.php';
use PopNow\Client;
$client = new Client(); // reads POPNOW_API_KEY
$task = $client->createTask(
model: 'google/nano-banana-2.1/text-to-image',
input: ['prompt' => 'A small red fox curled up in a teacup, soft morning light'],
idempotencyKey: Client::idempotencyKey(),
waitSeconds: 60,
);
if (!Client::isTerminal($task)) {
$task = $client->waitForTerminal($task['taskId']);
}
foreach (Client::readyAssets($task) as $asset) {
echo $asset['url'], "\n";
}// build.gradle.kts
implementation("ai.popnow:popnow-java:0.1.0")import ai.popnow.*;
import java.util.Map;
import java.util.UUID;
public class Quickstart {
public static void main(String[] args) {
PopNowClient client = PopNowClient.builder().apiKeyFromEnvironment().build(); // POPNOW_API_KEY
CreateTaskRequest request = CreateTaskRequest.of("google/nano-banana-2.1/text-to-image",
Map.of("prompt", "A small red fox curled up in a teacup, soft morning light"));
// createTask + waitForTerminal; the key makes a resend return the original task
TaskRecord task = client.run(request, UUID.randomUUID().toString());
System.out.println(task.state());
for (TaskAsset asset : task.assets()) {
asset.url().ifPresent(System.out::println);
}
}
}npm install -g @popnow/cli
export POPNOW_API_KEY="sk-popnow-..."popnow jobs create \
--model google/nano-banana-2.1/text-to-image \
--input-json '{"prompt":"A small red fox curled up in a teacup, soft morning light"}' \
--waitexport POPNOW_API_KEY="sk-popnow-..."curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/nano-banana-2.1/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "16:9",
"resolution": "1k",
"output_format": "png"
}
}'認証
キーは Bearer トークンとして送信します。キーは sk-popnow- で始まり、使えるモデルや IP アドレスを制限できます。また、1日・1か月・累計の利用上限も設定できます。
API キーcurl https://api.popnow.ai/api/v1/models \
-H "Authorization: Bearer $POPNOW_API_KEY"すべてのライブラリとツール
すべて github.com/popnow-ai の GitHub にあります。
言語
ツールとプラグイン
AI エージェントとコーディングアシスタント向け
- MCP サーバー
Claude、ChatGPT、Cursor など任意の MCP クライアントに https://api.popnow.ai/mcp を追加すれば、画像や動画の生成を任せられます。
https://api.popnow.ai/mcp - Agent Skills
Claude Code、Codex などのコーディングエージェント向けのスキル。API、モデル、料金の情報が含まれます。
SKILL.md - llms.txt
言語モデルが読むための、API とドキュメントのプレーンテキストの地図です。
/llms.txt - OpenAPI 仕様
API 全体を OpenAPI ファイルで提供します。コードジェネレーターや API クライアントに使えます。
openapi.yaml
本番運用に必要な機能を標準搭載
- 見積もり
実行せずにリクエストの料金を見積もり、その見積もりを渡してタスクを作成できます。
POST /jobs/quote - 冪等性キー
安全に再試行できます。同じキーを使えば、二重に課金されず元のタスクが返ります。
Idempotency-Key - 署名付き Webhook
完了したタスクをあなたのサーバーに送信します。署名付きなので、送信元が PopNow であることを検証できます。
X-Webhook-Signature - レート制限
アカウントごとに10秒あたり最大1,000リクエスト。429 が返ったら、待つべき時間がレスポンスに示されます。
429 · Retry-After