So funktioniert die PopNow API
Was die API erzeugen kann, die fünf Begriffe, auf denen jede Seite aufbaut, und in welcher Reihenfolge du liest.
Mit der PopNow API nutzt deine eigene Software die Bild-, Video- und Audiomodelle, die du von popnow.ai kennst. Dieselben Modelle, dieselben Preise, dieselben Credits – nur per Code statt per Klick im Browser.
Was du erzeugen kannst
| Ergebnis | Beispiele |
|---|---|
| Bilder | Text zu Bild, Bildbearbeitung mit einer oder mehreren Referenzen, Hochskalieren, Hintergrund entfernen, Ebenen trennen |
| Video | Text zu Video, Bild zu Video, Video mit erstem und letztem Bild, Referenzvideo, Clips verlängern und bearbeiten, Lippensynchronisation, sprechende Avatare |
| Audio | Musik, Soundeffekte, Text-to-Speech, Ton für ein vorhandenes Video, Speech-to-Text |
Die vollständige Liste mit ID und Preis jedes Modells steht unter Modelle. Die API deckt nur Bild-, Video- und Audiogenerierung ab; Chat- und Textmodelle gehören nicht dazu.
Fünf Begriffe, die dir überall begegnen
Modell-ID
Alles, was du aufrufen kannst, hat eine ID der Form <maker>/<model>/<task>, zum Beispiel alibaba/wan-3.0/image-to-video oder google/nano-banana-2.1/edit. Sie steht im Feld model jeder Anfrage. Bildbearbeitung endet immer auf /edit. Werkzeuge von PopNow selbst, etwa zum Entfernen von Hintergründen, haben popnow als Maker.
Task
Eine Generierung dauert Sekunden bis Minuten, deshalb erzeugt jede Anfrage einen Task. Du bekommst sofort eine taskId und liest das Ergebnis, wenn es fertig ist. Ein Task läuft von queued über running in einen Endzustand: succeeded, failed oder expired. Details: Tasks.
Credits
Die API verbraucht dieselben Credits wie die Website. Ein Credit kostet zum Basiskurs 0,01 $. Wird ein Task angenommen, wird sein höchstmöglicher Preis reserviert; ist er fertig, zahlst du den tatsächlichen Betrag (nie mehr als die Reservierung), und der Rest wird freigegeben. Ein gescheiterter Task kostet nichts. Details: Credits und Abrechnung.
Idempotency-Key
Ein Netzwerk-Timeout verrät dir nicht, ob der Server deine Anfrage bekommen hat. Schick bei jedem neuen Task einen Idempotency-Key-Header mit, dann liefert eine Wiederholung mit demselben Schlüssel den ursprünglichen Task – statt einen zweiten zu erzeugen und zu berechnen. Details: Idempotenz.
Webhook
Statt einen Task immer wieder abzufragen, gib ihm eine callBackUrl. Wenn er fertig ist, schickt PopNow das vollständige Ergebnis an diese URL, signiert, damit du prüfen kannst, dass es von uns kommt. Details: Webhooks.
So sieht eine Anfrage aus
POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...
{ "model": "alibaba/wan-3.0/image-to-video",
"input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
"callBackUrl": "https://your-app.example.com/hooks/popnow" }Jede Antwort nutzt eine Hülle, { "code", "msg", "data", "request_id" }, wobei code: 200 Erfolg bedeutet.
In dieser Reihenfolge lesen
- Schnellstart – dein erstes Ergebnis in fünf Minuten.
- Authentifizierung – Schlüssel sicher aufbewahren und einschränken.
- Modelle – ein Modell wählen und seine Parameter lesen.
- Tasks und Webhooks – der komplette Ablauf.
- Medien – eigene Bilder, Videos und Audios senden.
- Fehler und Ratenlimits – vor dem Livegang.
Willst du ein Modell ausprobieren, bevor du Code schreibst? Jedes Modell hat auf seiner API-Seite auf popnow.ai einen Playground, der mit deinem Konto läuft – ganz ohne Schlüssel.