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. 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/quote liefert expectedChargeUsd und maxChargeUsd als USD-Dezimalstrings, ohne einen Task zu starten.
  • Den abgerechneten Betrag prüfen. costUsd ist die endgültige USD-Abbuchung eines Tasks, wenn settled true ist. 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ächeBezahlt aus
REST oder kompatible API mit einem sk-popnow--SchlüsselAPI-Guthaben
Playground auf einer API-ModellseiteAPI-Guthaben
Entwickler-MCP mit API-SchlüsselAPI-Guthaben
Gespeicherte Rezept-Läufe über die API oder das Entwickler-MCPAPI-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:

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. 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
Aus inhaltlichen Gründen abgelehntNichts
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.

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.

Auf dieser Seite