API-Guthaben und Erstattungen
Das separate API-USD-Guthaben, Modellpreise, freigegebene Task-Reservierungen und Hilfe bei Erstattungen von API-Zahlungen.
Die PopNow API hat ein eigenes USD-Guthaben. Aufrufe mit API-Schlüssel, das Entwickler-MCP und Playground-Läufe auf den API-Seiten verbrauchen es. Ein Modell kostet in der API dasselbe wie auf popnow.ai bei gleichen Einstellungen.
Diese Seite erklärt API-Aufladungen, Preise und freigegebene Reservierungen. Reservierungen, Angebote und Limits einzelner Tasks erklärt die API-Abrechnung.
API-Guthaben in einer Minute
- Beginnt bei $0. Lade unter API-Abrechnung API-Guthaben auf, bevor du kostenpflichtige Anfragen startest – auch für Playground-Tests.
- Eigene Finanzierung. Nur API-Aufladungen, die in der API-Abrechnung hinzugefügt werden, fließen in dieses Guthaben, und sie werden nur über die API ausgegeben.
- Vorher den Preis abfragen.
jobs/quoteliefertexpectedChargeUsdundmaxChargeUsdals USD-Dezimalstrings, ohne einen Task zu starten. - Den abgerechneten Betrag prüfen.
costUsdist die endgültige USD-Abbuchung eines Tasks, wennsettledtrueist. Fehlgeschlagene oder abgelaufene Tasks geben ihre Reservierung automatisch frei.
API-Guthaben aufladen
Verwalte API-Aufladungen und Zahlungsbelege unter API-Abrechnung mit den dort aktuell verfügbaren Zahlungsmethoden. Schlüssel erstellst und verwaltest du separat unter API-Schlüssel.
Was das API-Guthaben belastet
| Aufruf oder Oberfläche | Bezahlt aus |
|---|---|
REST oder kompatible API mit einem sk-popnow--Schlüssel | API-Guthaben |
| Playground auf einer API-Modellseite | API-Guthaben |
| Entwickler-MCP mit API-Schlüssel | API-Guthaben |
| Gespeicherte Rezept-Läufe über die API oder das Entwickler-MCP | API-Guthaben |
Kann eine API-Anfrage ihre Reservierung nicht decken, lade API-Guthaben unter API-Abrechnung auf.
So wird eine Generierung berechnet
Jedes Modell hat seine eigene Preisliste, festgelegt pro Option: pro Bild, pro Sekunde Video oder Audio, pro Song oder pro 1.000 Zeichen Sprache. Der Preis hängt davon ab, was du anforderst: Auflösung, Länge, Qualitätsstufe und bei manchen Modellen, wie viele Referenzdateien du schickst.
Einige API-Preisbeispiele in USD:
| Modell | Was du bekommst | USD |
|---|---|---|
| Z-Image Turbo | Ein Bild | $0.01 |
| Nano Banana 2.1 | Ein Bild in 1K / 2K / 4K | $0.048 / $0.072 / $0.162 |
| Seedream 5.0 Pro | Ein Bild in 1K / 2K | $0.036 / $0.072 |
| MiniMax H3 | Bild zu Video, 768p, 5 Sekunden | $0.185 |
| Suno v6 | Ein Song | $0.072 |
| Background Remover | Ein transparentes PNG | $0.0048 |
| Image Upscaler | Ein Foto, hochskaliert | $0.012 |
Modelle verlinkt die Modellreferenzseiten. Frage den aktuellen Preis für deine Einstellungen ab und behalte die USD-Dezimalgenauigkeit mit bis zu neun Nachkommastellen bei; runde API-Abbuchungen nicht. Der Playground auf den API-Seiten verbraucht dasselbe API-USD-Guthaben.
Lass dir den genauen Betrag nennen, bevor du etwas startest:
curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'import os, requests
quote = requests.post(
"https://api.popnow.ai/api/v1/jobs/quote",
headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
json={
"model": "minimax/h3/image-to-video",
"input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
},
timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
model: 'minimax/h3/image-to-video',
input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
}),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);Was bei einem fehlgeschlagenen Task passiert
Wird ein Task angenommen, wird sein höchstmöglicher USD-Preis als Reservierung vom API-Guthaben zurückgelegt. Wenn er endet:
| Ergebnis | Was du zahlst |
|---|---|
succeeded | Die tatsächliche USD-Abbuchung, nie mehr als die Reservierung; der ungenutzte Betrag wird freigegeben |
failed oder expired | Nichts; die Reservierung wird freigegeben |
| Aus inhaltlichen Gründen abgelehnt | Nichts |
Vor dem Start abgelehnt (400, 402, 403, 429 …) | Nichts; kein Task, keine Reservierung |
Eine freigegebene Reservierung stellt verfügbares API-Guthaben wieder her; sie erstattet keine Zahlung an Bank oder Karte. Lies costUsd zusammen mit settled im Task-Eintrag für den endgültigen USD-Betrag. Siehe API-Abrechnung.
Erstattungen von API-Zahlungen
Bei Fragen zu einer API-Aufladung oder Erstattung öffne die API-Abrechnung oder kontaktiere den Support. Nenne die Zahlungsreferenz oder Task-ID, aber niemals deinen API-Schlüssel.
Mögliche Fehler
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
40201 | Das verfügbare API-USD-Guthaben deckt die Reservierung nicht | Unter API-Abrechnung aufladen oder Auflösung, Länge oder Zahl der Ausgaben senken |
40202 | Der Task würde ein Ausgabelimit des Schlüssels überschreiten | Das Limit unter API-Schlüssel erhöhen oder entfernen oder auf die Zurücksetzung warten |
40901 | Der Preis hat sich seit dem Angebot geändert | Erneut abfragen und den neuen USD-Preis anzeigen |
Alle Codes stehen unter Fehler.
Kosten API-Aufrufe mehr als Generierungen auf der Website?
Nein. Für dasselbe Modell mit denselben Einstellungen gilt derselbe Preis. API-Aufrufe werden in USD vom API-Guthaben abgerechnet.
Muss ich die Freigabe einer Task-Reservierung beantragen?
Nein. Fehlgeschlagene und abgelaufene Tasks geben ihre Reservierung automatisch frei. Den endgültigen USD-Betrag findest du im abgerechneten costUsd des Tasks.
Kann ich eine API-Aufladung erstatten lassen?
Informationen zur Erstattungsberechtigung und Hilfe zu API-Zahlungen erhältst du unter API-Abrechnung oder beim Support.

