Credits und Abrechnung

Wie API-Aufrufe Credits verbrauchen, wie Reservierung und endgültige Abbuchung funktionieren, Preisabfrage vorab, Guthaben, Nutzung und Ausgabelimits.

Die API verbraucht dieselben Credits wie popnow.ai. Es gibt keinen eigenen API-Tarif, kein Abo und keinen Mindestumsatz: Kauf ein Credit-Paket, wenn du mehr brauchst – die Gratis-Credits zur Anmeldung funktionieren hier auch.

1 Credit = 0,01 $ zum Basiskurs. Größere Pakete enthalten Bonus-Credits, jeder Credit kostet dich also etwas weniger.
Preise gelten pro Modell und Option – pro Bild, pro Sekunde Video oder Audio, pro Anfrage oder pro 1.000 Zeichen Sprachausgabe. Die Seite jedes Modells listet sie auf.
Antworten nennen jeden Betrag doppelt: in ganzen Credits (credits, maxCredits, availableCredits …) und als US-Dollar-String (cost, maxCharge, available …). Nutze die Credit-Felder; die Dollar-Strings sind für die Buchhaltung da.

So wird ein Task abgerechnet

hold

settlerelease

Bei Annahme werden Credits reserviert und genau einmal aufgelöst: nach tatsächlicher Nutzung abgerechnet oder vollständig freigegeben.

Reservieren. Nimmt createTask einen Task an, wird der höchstmögliche Preis von deinem Guthaben zurückgelegt (estimatedCredits). Reservierte Credits lassen sich nicht doppelt ausgeben, sind aber noch nicht abgebucht.
Abrechnen oder freigeben. Wenn der Task fertig ist:
- succeeded → du zahlst den tatsächlichen Verbrauch, auf ganze Credits aufgerundet und nie mehr als die Reservierung. Der Rest fließt zurück aufs Guthaben.
- failed oder expired → die gesamte Reservierung wird freigegeben. Du zahlst nichts.

Der Task-Eintrag zeigt den Stand: Solange settled false ist, ist credits die Reservierung; sobald settled true ist, ist credits die endgültige Abbuchung.

Ein paar Modelle berechnen Anfragen, die ihr Hersteller aus inhaltlichen Gründen abgelehnt hat. Wo das gilt, steht es auf der Modellseite; überall sonst ist ein Fehlschlag kostenlos.

Situation	Wird berechnet?
`createTask` abgelehnt (`400`, `402`, `403`, `429`, `50301` …)	Nein – kein Task, keine Reservierung
Task `succeeded`	Ja, der tatsächliche Betrag, gedeckelt durch die Reservierung
Task `failed` oder `expired`	Nein, außer im oben genannten Fall inhaltlicher Ablehnung
Deine Verbindung brach nach dem Senden ab	Unklar, bis du nachsiehst – sende mit demselben `Idempotency-Key` erneut, um den Task zu finden
Tasks, Modelle, Guthaben oder Nutzung lesen	Nie

Erst nach dem Preis fragen

POST /api/v1/jobs/quote nimmt genau den Body, den du an createTask schicken würdest, und nennt den Preis, ohne etwas anzulegen oder Credits zu reservieren:

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "alibaba/wan-3.0/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "resolution": "720p", "duration_seconds": 5}}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "quoteId": "q_…",
    "model": "alibaba/wan-3.0/image-to-video",
    "maxCredits": 68,
    "expectedCredits": 68,
    "estimatedCost": "0.68",
    "maxCharge": "0.68",
    "currency": "USD",
    "quantity": "5",
    "unit": "per_second",
    "expiresAt": "2026-10-16T09:25:00Z"
  },
  "request_id": "req_…"
}

maxCredits ist das Maximum, das die Anfrage kosten kann – der Betrag, der reserviert wird. expectedCredits ist das, was sie normalerweise kostet; die beiden unterscheiden sich nur, wenn die endgültige Abbuchung vom Ergebnis abhängt, etwa von der echten Länge eines Clips.

Damit sich der Preis zwischen Anzeige und Ausführung nicht ändert, übergib quoteId und expectedCredits (das angezeigte maxCredits) innerhalb von fünf Minuten an createTask. Hat sich etwas geändert, antwortet createTask mit 40901 und reserviert nichts; frag dann erneut an.

Guthaben

curl "https://api.popnow.ai/api/v1/chat/credit" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

availableCredits ist, was neue Tasks nutzen können, heldCredits ist für laufende Tasks zurückgelegt, und totalCredits ist beides zusammen (available, held und total nennen dieselben Beträge in US-Dollar). Der Pfadname ist historisch und hat nichts mit Chat zu tun. Deckt das verfügbare Guthaben die Reservierung eines neuen Tasks nicht, liefert createTask 40201.

Nutzung

GET /api/v1/usage?from=2026-10-01&to=2026-10-16 liefert für den aufrufenden Schlüssel die Zahl der Tasks, wie viele erfolgreich waren und wie viele scheiterten und was sie in Credits gekostet haben – insgesamt (totalCredits), pro Tag und pro Modell. Die Daten sind UTC, to ist exklusiv, der Zeitraum höchstens 92 Tage. Gezählt werden nur abgerechnete Beträge, die Summe eines Tages kann sich also noch bewegen, während späte Tasks fertig werden. Dieser Bericht ist auf 30 Anfragen pro Minute begrenzt; fürs ganze Konto nimm die Nutzungsseite der API-Konsole.

Ausgabelimits

Jeder Schlüssel kann ein Tages-, Monats- und Gesamtlimit haben, eingestellt in der API-Konsole und angezeigt in Credits. Eine Anfrage, die ein Limit überschreiten würde, liefert 40202 und reserviert nichts. Tageslimits setzen um 00:00 UTC zurück, Monatslimits am 1. um 00:00 UTC, ein Gesamtlimit nie. Ohne eigene Einstellung haben Schlüssel keine Limits.

Credits kaufen und Erstattungen

Credits kaufst du auf der Website, nicht über die API. Pakete und Preise stehen auf der Preisseite; was wann erstattet werden kann, erklärt die Erstattungsrichtlinie.