SDKs, CLI und Open-Source-Tools

Alles, was PopNow für Entwickler veröffentlicht, ist Open Source unter der popnow-ai-Organisation auf GitHub, unter MIT-Lizenz. Die SDKs kapseln dieselbe REST-API, die diese Docs beschreiben. Deshalb gilt auf dieser Seite weiterhin alles andere: dieselben Modell-IDs, dieselben input-Felder, dasselbe API-USD-Guthaben.

Die Pakete sind auf PyPI, npm, Packagist, Maven Central und im Comfy Registry veröffentlicht; installiere sie mit den Befehlen auf dieser Seite. Reines HTTP funktioniert ebenfalls weiter; jedes Beispiel in diesen Docs nutzt curl, fetch oder requests.

Auf einen Blick

Jedes Werkzeug braucht einen API-Schlüssel aus der API-Konsole. Lege ihn in POPNOW_API_KEY ab; die SDKs und die CLI lesen ihn von dort:

export POPNOW_API_KEY="sk-popnow-..."

Python-SDK

popnow-python hat einen synchronen Client (PopNow) und einen asynchronen (AsyncPopNow), typisierte Ergebnisse, automatische Idempotency-Key-Header, Wiederholungen bei 429 und 503, Datei-Uploads, die Asset-Bibliothek und die Prüfung von Webhook-Signaturen. Es braucht Python 3.9 oder neuer und hängt nur von httpx ab.

pip install popnow

from popnow import PopNow

client = PopNow()  # reads POPNOW_API_KEY

task = client.images.generate(
    model="alibaba/z-image-turbo/text-to-image",
    prompt="A small red fox curled up in a teacup, soft morning light",
)
print(task.state, task.cost, "USD", task.urls[0])

images.generate legt den Task an, wartet darauf und wirft TaskFailedError, wenn er nicht erfolgreich ist. Die Methoden auf niedrigerer Ebene client.jobs.quote(), create(), get() und wait() entsprechen eins zu eins den Task-Endpunkten.

JavaScript- und TypeScript-SDK

popnow-js hat keine Laufzeitabhängigkeiten und nutzt das globale fetch. Es läuft deshalb auf Node.js 18+, Deno, Bun, Cloudflare Workers und anderen Edge-Runtimes. Es enthält ESM- und CommonJS-Builds mit Typdefinitionen.

npm install popnow

Auf Deno und Bun ist es außerdem auf JSR verfügbar: deno add jsr:@popnow/popnow oder npx jsr add @popnow/popnow.

import { PopNow } from 'popnow';

const popnow = new PopNow(); // reads POPNOW_API_KEY

const task = await popnow.jobs.createAndWait({
  model: 'alibaba/z-image-turbo/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);

createAndWait sendet für dich einen Idempotency-Key und fragt so lange ab, bis der Task endgültig ist. jobs.quote, jobs.create und jobs.wait sind da, wenn du vorher den Preis wissen oder an anderer Stelle warten willst.

Kommandozeile

popnow-cli installiert einen Befehl popnow für Skripte, CI-Jobs und schnelle Tests aus dem Terminal. Er braucht Node.js 22.12 oder neuer:

npm install -g @popnow/cli
popnow --help

Um ihn einmalig ohne Installation auszuführen: npx @popnow/cli status.

Go und PHP

popnow-go ist ein gewöhnliches Go-Modul (Go 1.23+):

go get github.com/popnow-ai/popnow-go

popnow-php (PHP 8.1+) ist popnow/popnow auf Packagist:

composer require popnow/popnow

Java

popnow-java ist ein Client für Java 17+, Kotlin und andere JVM-Sprachen, veröffentlicht auf Maven Central als ai.popnow:popnow-java. Seine einzige Abhängigkeit ist Jackson Databind; HTTP läuft über den eigenen HttpClient des JDK.

<dependency>
  <groupId>ai.popnow</groupId>
  <artifactId>popnow-java</artifactId>
  <version>0.1.0</version>
</dependency>

dependencies {
    implementation("ai.popnow:popnow-java:0.1.0")
}

import ai.popnow.*;
import java.util.Map;
import java.util.UUID;

PopNowClient client = PopNowClient.builder().apiKeyFromEnvironment().build(); // POPNOW_API_KEY

CreateTaskRequest request = CreateTaskRequest.of("alibaba/z-image-turbo/text-to-image",
        Map.of("prompt", "A small red fox curled up in a teacup, soft morning light"));

TaskRecord task = client.run(request, UUID.randomUUID().toString()); // createTask + waitForTerminal
System.out.println(task.state() + " for " + task.cost() + " USD");

run legt den Task unter dem Idempotency-Key an, den du übergibst, und wartet, bis er endgültig ist. createTask und waitForTerminal sind da, wenn du die beiden Schritte getrennt haben willst.

MCP und Agent Skills

Der Remote-MCP-Server braucht kein Paket: Füge https://api.popnow.ai/mcp zu ChatGPT, Claude, Cursor, VS Code oder Claude Code hinzu. popnow-mcp sammelt kopierfertige Konfigurationen für jeden Client und eine kleine stdio-Bridge für Clients, die nur lokale Server starten können. Die Bridge ist auf npm als @popnow/mcp veröffentlicht, sodass npx -y @popnow/mcp sie ohne Installationsschritt startet.

popnow-skills bringt Coding-Agenten bei, mit der REST-API Videos, Bilder, Musik und Voiceovers zu erzeugen und die API-Referenz nachzuschlagen. In Claude Code:

/plugin marketplace add popnow-ai/popnow-skills
/plugin install popnow@popnow-skills

Die README beschreibt Codex, die Claude-Apps und andere Agenten.

Beispiele und Integrationen

• popnow-api enthält die OpenAPI-Datei, lauffähige curl-, Python- und Node.js-Beispiele und einen importierbaren n8n-Workflow. Richte einen Code-Generator auf die OpenAPI-Datei, wenn du einen Client in einer anderen Sprache brauchst.
• popnow-blender ist der Quellcode des Blender-Add-ons. Zur Installation lädst du die Zip-Datei von popnow.ai/blender herunter; das Repository kann dieselbe Zip-Datei auch selbst bauen.
• popnow-comfyui ist ein Node-Paket für ComfyUI im Comfy Registry: ein Node pro Modell, dazu PopNow Generate und PopNow LoRA. Öffne im ComfyUI Manager den Custom Nodes Manager, suche nach PopNow und klicke auf Install, oder führe comfy node install popnow-comfyui aus. ComfyUI enthält die vollständige Anleitung und den Einzeldatei-Node, falls du lieber eine Datei hast, die du in einer Minute durchlesen kannst.
• n8n-nodes-popnow ist ein n8n-Community-Node auf npm für selbst gehostetes n8n. Öffne Settings > Community Nodes > Install und gib n8n-nodes-popnow ein, oder installiere ihn über die Shell und starte n8n neu. Er ist noch kein verifizierter Node, deshalb kann n8n Cloud ihn nicht installieren; der HTTP-Request-Workflow braucht keine Installation und funktioniert dort ebenfalls.
• popnow-proxy ist eine kleine serverseitige Route für Next.js, Express und andere fetch-Runtimes. Eine Browser-, Mobil- oder Desktop-App ruft deinen Server auf, und der Proxy ergänzt dort den API-Schlüssel, sodass der Schlüssel nie im Client landet. Er braucht Node.js 22.12 oder neuer.
• popnow-bot ist ein Telegram- und Discord-Bot, den du selbst mit Docker betreibst: Bilder, Videos und Video-Effekte im Chat, mit Preisprüfung vor kostenpflichtigen Läufen und täglichen Ausgabelimits. Klone das Repository und starte es mit docker compose up -d --build, oder lade das fertige Image popnow/popnow-bot von Docker Hub.

# n8n community node, from a shell on self-hosted n8n
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install n8n-nodes-popnow

# server-side proxy
npm install @popnow/proxy

Gibt es ein offizielles PopNow-SDK?

Ja. Die Python- und JavaScript-SDKs, die CLI sowie die Go-, PHP- und Java-Clients auf dieser Seite werden von PopNow gepflegt und sind Open Source unter github.com/popnow-ai.

Sind die SDKs auf npm oder PyPI?

Ja. pip install popnow installiert das Python-SDK von PyPI, npm install popnow das JavaScript-SDK von npm. Die CLI ist @popnow/cli auf npm, der PHP-Client ist popnow/popnow auf Packagist, der Java-Client ist ai.popnow:popnow-java auf Maven Central, und das ComfyUI-Paket ist popnow-comfyui im Comfy Registry. Die Datei CHANGELOG.md jedes Repositorys listet seine Releases.

Soll ich ein SDK verwenden oder die REST-API direkt aufrufen?

Beides ist möglich. Die SDKs bringen Wiederholungen, Idempotenz-Schlüssel, Abfragen und typisierte Ergebnisse mit. Reines HTTP braucht nichts installiert und ist das, was jedes Beispiel in diesen Docs zeigt.

Kosten die SDKs etwas?

Nein. Der Code ist unter der MIT-Lizenz kostenlos; API-Generierungen verbrauchen das separate API-USD-Guthaben zu denselben Modellpreisen wie die Website. Lade unter API-Abrechnung auf. OAuth-MCP verwendet Website-Credits; API-Key-MCP verwendet API-USD.

Wo melde ich einen Fehler?

Öffne ein Issue im Repository, zu dem der Fehler gehört. Bei einem Sicherheitsproblem folge der Datei SECURITY.md in diesem Repository, statt ein öffentliches Issue zu eröffnen.

Siehe auch