PopNowAPI-Doku
API-Guthaben und Abrechnung
Hauptinhalt

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/quote liefert expectedChargeUsd und maxChargeUsd als USD-Dezimalstrings, ohne einen Task zu starten.
  • Den abgerechneten Betrag lesen. costUsd ist die endgültige USD-Abbuchung eines Tasks, wenn settled true ist. 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ächeVerwendetes Guthaben
REST oder kompatible API mit einem sk-popnow--SchlüsselAPI-USD
Playground auf einer API-ModellseiteAPI-USD
MCP mit API-SchlüsselAPI-USD
Website-Generierung oder MCP über OAuthWebsite-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:

ModellWas du bekommstUSD
Z-Image TurboEin Bild$0.01
Nano Banana 2.1Ein Bild in 1K / 2K / 4K$0.048 / $0.072 / $0.162
Seedream 5.0 ProEin Bild in 1K / 2K$0.036 / $0.072
MiniMax H3Bild zu Video, 768p, 5 Sekunden$0.185
Suno v6Ein Song$0.072
Background RemoverEin transparentes PNG$0.0048
Image UpscalerEin 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}}'
Python
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")
JavaScript
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:

ErgebnisWas du zahlst
succeededDie tatsächliche USD-Abbuchung, nie mehr als die Reservierung; der ungenutzte Betrag wird freigegeben
failed oder expiredNichts; die Reservierung wird freigegeben, abgesehen von modellspezifischen Gebühren für inhaltliche Ablehnungen
Aus inhaltlichen Gründen abgelehntNichts, 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

CodeBedeutungWas du tun kannst
40201Das verfügbare API-USD-Guthaben deckt die Reservierung nichtUnter API-Abrechnung aufladen oder Auflösung, Länge oder Zahl der Ausgaben senken
40202Der Task würde ein Ausgabelimit des Schlüssels überschreitenDas Limit unter API-Schlüssel erhöhen oder entfernen oder auf die Zurücksetzung warten
40901Der Preis hat sich seit dem Angebot geändertErneut 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.

Auf dieser Seite