SDKs, Bibliotheken und Tools
Offizielle Clients für Python, JavaScript, Go, PHP und Java, eine CLI, ein MCP-Server für KI-Agenten und Plugins für die Tools, die du schon nutzt. Alles Open Source.
Schnellstart
Installiere den Client, setze POPNOW_API_KEY und erzeuge dein erstes Bild.
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"
}
}'Authentifizierung
Sende deinen Schlüssel als Bearer-Token. Schlüssel beginnen mit sk-popnow- und lassen sich auf bestimmte Modelle und IP-Adressen beschränken, mit täglichen, monatlichen und Gesamtausgabenlimits.
API-Schlüsselcurl https://api.popnow.ai/api/v1/models \
-H "Authorization: Bearer $POPNOW_API_KEY"Alle Bibliotheken und Tools
Alles liegt auf GitHub unter github.com/popnow-ai.
Sprachen
- popnow-go
Go-Client mit typisierten Anfragen, Warte-Helfern und Iteratoren.
go get github.com/popnow-ai/popnow-goGitHubpkg.go.dev
Tools und Plugins
- popnow-comfyui
ComfyUI-Custom-Nodes, die PopNow-Modelle innerhalb deines Graphen ausführen.
GitHubComfy Registry - popnow-bot
Selbst gehosteter Telegram- und Discord-Bot für Bilder, Videos und Videoeffekte, mit Ausgabenlimits.
GitHubDocker Hub
Für KI-Agenten und Coding-Assistenten
- MCP-Server
Füge https://api.popnow.ai/mcp zu Claude, ChatGPT, Cursor oder einem anderen MCP-Client hinzu und lass ihn Bilder und Videos für dich erzeugen.
https://api.popnow.ai/mcp - Agent Skills
Skills für Claude Code, Codex und andere Coding-Agenten, die die API, die Modelle und die Preise kennen.
SKILL.md - llms.txt
Eine Klartext-Übersicht über die API und die Doku, zum Lesen für Sprachmodelle.
/llms.txt - OpenAPI-Spezifikation
Die vollständige API als OpenAPI-Datei, für Code-Generatoren und API-Clients.
openapi.yaml
Für den Produktivbetrieb gebaut
- Angebote
Bepreise eine Anfrage, ohne sie auszuführen, und übergib dann das Angebot, um den Auftrag zu erstellen.
POST /jobs/quote - Idempotenz-Schlüssel
Sicher wiederholen: Derselbe Schlüssel liefert den ursprünglichen Auftrag zurück, statt doppelt zu berechnen.
Idempotency-Key - Signierte Webhooks
Erhalte den fertigen Auftrag an deinen Server gesendet, signiert, damit du prüfen kannst, dass er von uns stammt.
X-Webhook-Signature - Rate-Limits
Bis zu 1.000 Anfragen pro 10 Sekunden und Konto. Ein 429 sagt dir, wie lange du warten musst.
429 · Retry-After
In wenigen Minuten loslegen
Ein Schlüssel für jedes Modell, ein USD-Guthaben, das du bei Bedarf auflädst, und ein exakter Preis vor jedem Lauf.