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, getrennt von den Website-Credits. Aufrufe mit API-Schlüssel, MCP-Verbindungen mit API-Schlüssel und Playground-Läufe verbrauchen API-USD. Über OAuth verbundenes MCP verwendet weiterhin Website-Credits. Für dasselbe Modell mit denselben Einstellungen gelten auf API und Website dieselben Preise; die Guthaben lassen sich weder übertragen noch gegenseitig verwenden.
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.
- Getrennte Finanzierung. Website-Credit-Pakete, Bonus-Credits und Prämien bezahlen keine API-Aufrufe. API-Guthaben bezahlt keine Website-Generierungen oder OAuth-MCP-Aufrufe.
- Vorher den Preis abfragen.
jobs/quoteliefertexpectedChargeUsdundmaxChargeUsdals USD-Dezimalstrings, ohne einen Task zu starten. - Den abgerechneten Betrag lesen.
costUsdist die endgültige USD-Abbuchung eines Tasks, wennsettledtrueist. Fehlgeschlagene oder abgelaufene Tasks geben ihre Reservierung automatisch frei, vorbehaltlich modellspezifischer Gebühren für inhaltliche Ablehnungen.
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.
Website-Paketboni, Einladungsprämien und andere Website-Credits erhöhen das API-Guthaben nicht. Paketgrößen, Erstattungsfristen und Ablaufregeln der Website sind keine Bedingungen für API-Aufladungen.
Welches Guthaben wird verwendet
Zugangsdaten und Oberfläche bestimmen, welches Guthaben belastet wird:
| Aufruf oder Oberfläche | Verwendetes Guthaben |
|---|---|
REST oder kompatible API mit einem sk-popnow--Schlüssel | API-USD |
| Playground auf einer API-Modellseite | API-USD |
| MCP mit API-Schlüssel | API-USD |
| Website-Generierung oder MCP über OAuth | Website-Credits |
Eine Aufladung erhöht nicht das andere Guthaben. Reicht eine API-Reservierung nicht aus, lade API-Guthaben auf, statt Website-Credits zu kaufen.
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 auf ganze Credits. 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, abgesehen von modellspezifischen Gebühren für inhaltliche Ablehnungen |
| Aus inhaltlichen Gründen abgelehnt | Nichts, außer bei Modellen, deren Seite Ablehnungen als kostenpflichtig ausweist |
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; Website-Generierungen und OAuth-MCP-Aufrufe verbrauchen Website-Credits. Die Guthaben bleiben getrennt.
Muss ich die Freigabe einer Task-Reservierung beantragen?
Nein. Fehlgeschlagene und abgelaufene Tasks geben ihre Reservierung automatisch frei, vorbehaltlich modellspezifischer Gebühren für inhaltliche Ablehnungen. 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.
Gelten die Ablaufregeln der Website-Credits für API-Guthaben?
Ablaufregeln für Website-Credit-Pakete und Prämien bestimmen nicht die API-Bedingungen. Informiere dich unter API-Abrechnung oder frage den Support nach deinem API-Guthaben.
Kann ich die API mit Website-Credits bezahlen?
Nein. Lade unter API-Abrechnung API-Guthaben auf. Website-Credits bezahlen keine API-Aufrufe, API-Guthaben bezahlt keine Website-Generierungen, und die Guthaben lassen sich nicht übertragen.

