SDK, biblioteki i narzędzia
Oficjalne klienty dla Python, JavaScript, Go, PHP i Java, CLI, serwer MCP dla agentów AI oraz wtyczki do narzędzi, których już używasz. Wszystko jest open source.
Szybki start
Zainstaluj klienta, ustaw POPNOW_API_KEY i wygeneruj pierwszy obraz.
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"
}
}'Uwierzytelnianie
Przesyłaj klucz jako token Bearer. Klucze zaczynają się od sk-popnow- i można je ograniczyć do wybranych modeli oraz adresów IP, a także ustawić dzienny, miesięczny i łączny limit wydatków.
Klucze APIcurl https://api.popnow.ai/api/v1/models \
-H "Authorization: Bearer $POPNOW_API_KEY"Wszystkie biblioteki i narzędzia
Wszystko jest na GitHubie w organizacji github.com/popnow-ai.
Języki
- popnow-go
Klient Go z typowanymi żądaniami, pomocnikami do czekania i iteratorami.
go get github.com/popnow-ai/popnow-goGitHubpkg.go.dev
Narzędzia i wtyczki
- popnow-comfyui
Własne węzły ComfyUI, które uruchamiają modele PopNow wewnątrz twojego grafu.
GitHubComfy Registry - popnow-bot
Samodzielnie hostowany bot dla Telegrama i Discorda: obrazy, wideo i efekty wideo z limitami wydatków.
GitHubDocker Hub
Dla agentów AI i asystentów kodowania
- Serwer MCP
Dodaj https://api.popnow.ai/mcp do asystenta, na przykład Claude, ChatGPT lub Cursor, albo do dowolnego klienta MCP, a asystent wygeneruje dla ciebie obrazy i wideo.
https://api.popnow.ai/mcp - Agent Skills
Umiejętności dla Claude Code, Codex i innych agentów kodowania, które znają API, modele i ceny.
SKILL.md - llms.txt
Tekstowa mapa API i dokumentacji do czytania przez modele językowe.
/llms.txt - Specyfikacja OpenAPI
Pełne API w postaci pliku OpenAPI, dla generatorów kodu i klientów API.
openapi.yaml
Gotowe do produkcji
- Wyceny
Wyceń żądanie bez uruchamiania, a potem przekaż wycenę przy tworzeniu zadania.
POST /jobs/quote - Klucze idempotentności
Ponawiaj żądania bezpiecznie: ten sam klucz zwróci pierwotne zadanie zamiast pobrać opłatę dwa razy.
Idempotency-Key - Podpisane webhooki
Gotowe zadanie trafia na twój serwer z podpisem, dzięki czemu sprawdzisz, że przyszło od nas.
X-Webhook-Signature - Limity żądań
Do 1000 żądań na 10 sekund na konto; odpowiedź 429 mówi, jak długo czekać.
429 · Retry-After
Zacznij w kilka minut
Jeden klucz do wszystkich modeli, saldo w USD, które doładowujesz w razie potrzeby, i dokładna cena przed każdym uruchomieniem.