CheaperGen

Anleitungen

Abrechnung & Guthaben

Vorausbezahltes Guthaben, Reservierung und Abrechnung des Preises einer Generierung, automatische Erstattungen fehlgeschlagener Aufträge, automatische Aufladung und Guthabenabfrage über die API.

CheaperGen ist ein Prepaid- und Pay-as-you-go-Modell. Sie laden Guthaben in US-Dollar auf; jede Generierung wird von diesem Guthaben abgezogen, und berechnet werden nur erfolgreiche Ergebnisse. Ein Abonnement ist nicht erforderlich – optionale Monatstarife laden automatisch Guthaben auf und können Preise senken. Es fallen weder Gebühren pro Nutzerplatz noch Plattformgebühren an.

Guthaben#

  • Lade unter Dashboard → Billing Guthaben per Karte auf (bei sehr hohen Beträgen ist im Dashboard auch eine Banküberweisung möglich). Stripe verarbeitet die Zahlungen; erfolgreiche Zahlungen werden sofort gutgeschrieben.
  • Guthaben verfällt nicht.
  • Ein Guthaben für alle Modelle, die API und das Studio.
  • Belege für jede Zahlung finden Sie im Dashboard. Enterprise-Konten können stattdessen monatlich per Rechnung bezahlen – siehe Enterprise.
  • Guthaben wird im Voraus bezahlt und ist außer bei gesetzlicher Verpflichtung nicht erstattungsfähig; siehe Nutzungsbedingungen. Fehlgeschlagene und abgebrochene Generierungen werden immer Ihrem Guthaben gutgeschrieben.

Abrechnung einer Generierung#

  1. Preis abfragen. Preis abfragen. Beim Absenden berechnen wir den Preis anhand der Eingaben – bei Videos nach Auflösung und Dauer, bei Bildern nach Größe und Anzahl – zum veröffentlichten Modellpreis.
  2. Betrag reservieren. Betrag reservieren. Dieser wird sofort von Ihrem Guthaben abgezogen und die Generierung in die Warteschlange gestellt. Reicht Ihr Guthaben nicht aus, schlägt die Anfrage mit 402 insufficient_balance fehl und es wird nichts berechnet.
  3. Endgültig abrechnen. Bei Erfolg wird der reservierte Betrag zur endgültigen Belastung. Weicht die tatsächliche Nutzung vom Preisangebot ab, wird die Differenz als Korrektur verbucht.
  4. Erstatten. Wenn eine Generierung fehlschlägt oder Sie sie abbrechen, solange sie noch in der Warteschlange steht, wird der gesamte reservierte Betrag automatisch Ihrem Guthaben gutgeschrieben.

Für jede Generierung werden Kosten ausgewiesen. Während der Ausführung entspricht der Betrag der Reservierung und estimated ist true; nach Abschluss ist estimated gleich false:

{
  "status": "succeeded",
  "cost": {
    "amount_usd": 0.4494,
    "currency": "usd",
    "estimated": false
  }
}

Abrechnungseinheiten#

  • Video wird pro Sekunde Ausgabe in der gewählten Auflösung abgerechnet. Ein 10-Sekunden-Clip kostet doppelt so viel wie ein 5-Sekunden-Clip.
  • Bilder werden pro Bild in der gewählten Größe abgerechnet; num_images: 4 kostet vier Bilder.
  • Bei Seedance-Modellen erfolgt die Abrechnung nach Video-Tokens wie bei der offiziellen API: tokens = seconds × width × height × 24 ÷ 1024. Die Website-Preise sind bei 16:9 auf den entsprechenden Sekundenpreis umgerechnet; andere Seitenverhältnisse weichen leicht ab.
  • Referenzvideos erhöhen bei Modellen, die dafür abrechnen, die Kosten für Videosekunden – siehe unten. Referenzbilder und Audio ändern den Preis nicht.
  • Preise werden mit bis zu vier Dezimalstellen angezeigt und auf den nächsten Betrag von $0.0001 pro Anfrage gerundet.

Die vollständige Preisliste aller Modelle und Tarifstufen finden Sie auf der Preisseite.

Kosten vor der Ausführung schätzen#

POST /api/v1/quote/{endpoint} berechnet den Preis einer Eingabe, ohne sie auszuführen. Dafür ist kein API-Schlüssel erforderlich; Inhaltsfelder wie Prompts und Bilder werden ignoriert. Zum Beispiel kostet Seedance 2.0 Fast mit diesen Einstellungen $0,45:

curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0-fast/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"aspect_ratio":"16:9","resolution":"720p","duration":5}'
200 OK
{
  "amount_usd": 0.4494,
  "list_usd": 0.6048,
  "list_price_source": "official",
  "list_price_label": "Official",
  "discount_pct": 26,
  "available": true,
  "currency": "usd"
}

amount_usd ist der Preis, den du zahlst, list_usd der Listenpreis für dieselbe Anfrage und discount_pct deine prozentuale Ersparnis. list_price_source lautet official, wenn list_usd der eigene Listenpreis des Entwicklers ist, und reference, wenn es sich um einen anderen Vergleichspreis handelt, angegeben von list_price_label (zum Beispiel fal API für ein Modell, dessen Entwickler keine internationale API anbietet).

Referenzvideo#

In reference-to-video-Modi wird die Dauer von Referenzvideos wie die Ausgabe abgerechnet, genau wie bei den offiziellen APIs:

  • Seedance (2.0, 2.0 Fast, 2.0 Mini, 2.5): Tokens = (Referenzvideosekunden + Ausgabesekunden) × Breite × Höhe × 24 ÷ 1024, zu einem niedrigeren Token-Tarif für mit Videoeingabe – eine Anfrage mit Video kostet insgesamt also mehr, aber pro Sekunde weniger.
  • Wan 3.0, Wan 3.0 Prime und MiniMax H3: Referenzvideosekunden werden zum selben Sekundentarif wie die Ausgabe abgerechnet.

Wir messen jede Referenzdatei beim Absenden auf unseren Servern – nicht anhand der Anfrage – und reservieren den Preis für die gemessene Dauer. cost.reference_video_seconds der Generierung zeigt die einbezogenen Sekunden. Pro abgerechneter Sekunde (5 s Referenz + 5 s Ausgabe, 16:9):

Preise mit Referenzvideo
ModellTarifstufeOffiziellCheaperGen
Seedance 2.0480p$0,0432$0,0411
Seedance 2.0720p$0,0929$0,0883
Seedance 2.01080p$0,2284$0,2170
Seedance 2.04K$0,4666$0,4433
Seedance 2.5480p$0,0615$0,0585
Seedance 2.5720p$0,1382$0,1314
Seedance 2.51080p$0,3402$0,3232
Seedance 2.0 Fast480p$0,0331$0,0298
Seedance 2.0 Fast720p$0,0713$0,0539
Seedance 2.0 Mini480p$0,0211$0,0178
Seedance 2.0 Mini720p$0,0454$0,0382
Wan 3.0480p$0,0500$0,0379
Wan 3.0720p$0,1000$0,0757
Wan 3.01080p$0,2000$0,1513
Wan 3.0 Prime480p$0,0680$0,0582
Wan 3.0 Prime720p$0,1400$0,1198
Wan 3.0 Prime1080p$0,2800$0,2394
MiniMax H3768P$0,0800$0,0570
MiniMax H32K$0,1300$0,1068
MiniMax H3 Fast480P$0,0500$0,0369
MiniMax H3 Fast768P$0,0800$0,0546

Anfrage mit Referenzvideo schätzen#

/quote lädt keine Dateien herunter. Übergeben Sie die erwarteten Clip-Längen als reference_video_durations (optional auch reference_audio_durations), in Sekunden, einen Wert pro Clip. Das ist ein Schätzwert: /run misst die tatsächlichen Dateien und reserviert diesen Preis. Der Playground ermittelt die Dauer im Browser auf dieselbe Weise.

curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.0/reference-to-video \
  -H "Content-Type: application/json" \
  -d '{"resolution":"720p","duration":5,"reference_video_durations":[4.2,3]}'
200 OK
{
  "amount_usd": 1.076479,
  "list_usd": 1.133136,
  "list_price_source": "official",
  "list_price_label": "Official",
  "discount_pct": 5,
  "available": true,
  "currency": "usd",
  "reference_video_seconds": 7.2
}

Automatische Aufladung#

Automatisches Aufladen verhindert, dass Produktionsaufträge wegen 402 fehlschlagen. Hinterlege unter Dashboard → Billing eine Karte und wähle einen Schwellenwert sowie einen Betrag. Nach jeder Abbuchung prüfen wir, ob dein Guthaben unter den Schwellenwert gefallen ist. Falls ja, belasten wir die gespeicherte Karte mit dem gewählten Betrag und schreiben ihn deinem Guthaben gut.

Falls eine Zahlung für die automatische Aufladung fehlschlägt

Die automatische Aufladung wird pausiert; der Grund erscheint im Dashboard. Generierungen laufen weiter, bis Ihr Guthaben aufgebraucht ist. Danach erhalten sie 402 insufficient_balance. Aktualisieren Sie Ihre Karte, um fortzufahren.

Monatstarife#

Pay as you go erfordert keinen Tarif. Wenn Sie jeden Monat generieren, schreibt ein Tarif automatisch Guthaben gut und kann Ihre Preise senken:

  • Starter – $99 pro Monat, vollständig Ihrem Guthaben gutgeschrieben, zu den Standardpreisen.
  • Pro – $499 pro Monat, vollständig Ihrem Guthaben gutgeschrieben, außerdem sind die Preise von Pro bei den meisten Modellen niedriger.
  • Max – $4.999 pro Monat, vollständig Ihrem Guthaben gutgeschrieben, außerdem sind die Preise von Max bei den meisten Modellen niedriger.

Plan-Credits werden wie anderes Guthaben übertragen und verfallen nicht. Tarife verlängern sich monatlich, bis du kündigst; die Kündigung wird zum Ende des bezahlten Monats wirksam. Bei einem Upgrade beginnt sofort ein neuer Monat mit dem höheren Tarif. Berechnet wird dessen Preis abzüglich des Restwerts des laufenden Monats, der deinem Guthaben gutgeschrieben wird. Ein Downgrade gilt sofort; ab der nächsten monatlichen Abbuchung zahlst du den neuen Preis. Solange ein Pro- oder Max-Tarif aktiv ist, sind die meisten Modelle günstiger. Wie stark, hängt vom Modell ab; die Tarifpreise stehen auf der jeweiligen Modellseite. Der eigene Preis eines Modells für Anfragen mit deaktiviertem Sicherheitsfilter sinkt durch einen Tarif nicht. Bei Anfragen zum Tarifpreis geben Angebot und Generierung custom_price: true und volume_level zurück; GET /api/v1/account/pricing zeigt deinen Tarif. Verwalte ihn unter Dashboard → Billing. Benötigst du mehr? Wir vereinbaren individuelle Preise.

Ein Tarif macht eine Anfrage nie teurer als ohne Tarif. Es gilt der Tarifpreis auf der jeweiligen Modellseite. Er bleibt bestehen, wenn die dahinterliegende Kapazität nicht verfügbar ist und eine andere Kapazität die Anfrage zum selben Preis ausführen kann. Andernfalls wird eine neue Anfrage zu einem Preis zwischen Tarifpreis und Standardpreis angeboten — niemals zum Ausweichpreis, wenn ein Konto ohne Tarif den Standardpreis zahlt. Ein bereits zum Tarifpreis angenommener Auftrag kann nach einem Kapazitätsausfall zu einer anderen Kapazität mit höherem Preis wechseln, höchstens bis zum Standardpreis — über REST API und MCP, sofern die Anfrage nicht allow_fallback_price: false gesendet hat, und nur innerhalb von max_cost_usd (der Aufpreis wird dann reserviert; in der Generierung wird pricing nicht mehr als volume_level angezeigt). Studio-Aufträge kosten nie mehr als der beim Klick angezeigte Preis: Andernfalls schlagen sie fehl und werden vollständig erstattet.

Guthaben prüfen#

GET /api/v1/account gibt Ihr Guthaben, Ihr Bildguthaben und Ihre Einstellungen für automatische Aufladungen zurück:

curl https://cheapergen.com/api/v1/account \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"
200 OK
{
  "object": "account",
  "email": "you@company.com",
  "balance_usd": 42.5,
  "image_credit_usd": 0,
  "reserved_usd": 1.2,
  "auto_topup": {
    "enabled": true,
    "threshold_usd": 10,
    "amount_usd": 50
  },
  "limits": {
    "unlimited": false,
    "concurrent_generations": 20,
    "in_flight": 3,
    "requests_per_second": 10,
    "burst": 20,
    "tier": null
  }
}
  • balance_usd – sofort verfügbarer Betrag. Reservierungen für laufende Generierungen sind bereits abgezogen.
  • image_credit_usd – ein ausschließlich für Bilder verwendbares Guthaben, zum Beispiel ein Willkommensguthaben: Bildgenerierungen nutzen es vor Ihrem Guthaben; für Videos kann es nicht verwendet werden.
  • reserved_usd – der Gesamtbetrag, der derzeit für ausstehende und laufende Generierungen von Ihrem Guthaben reserviert ist. Nach Abschluss werden die Kosten abgebucht oder der Betrag wird erstattet.

Transaktionsverlauf#

Jede Änderung Ihres Guthabens wird im Transaktionsverlauf unter Dashboard → Billing festgehalten, zusammen mit dem Kontostand nach jedem Eintrag:

EintragBedeutung
TOPUPMit Karte aufgeladenes Guthaben.
AUTO_TOPUPDurch automatische Aufladung hinzugefügtes Guthaben.
CHARGEReservierter Betrag beim Absenden einer Generierung (negativ).
REFUNDEin zurückgegebener reservierter Betrag: vollständig, wenn die Generierung fehlschlug oder abgebrochen wurde, oder die Differenz, wenn ihr Preis vor dem Start sank (eine zum Notfallpreis reservierte Generierung, die wartete).
ADJUSTMENTVon CheaperGen gutgeschriebenes Guthaben (zum Beispiel aus Kulanz oder als Korrektur) oder eine von uns vorgenommene Korrektur. Es kann wie eine Aufladung verwendet werden, ist aber keine Zahlung und hat daher keine Rechnung.
PROMOWerbe- oder Kulanzguthaben von uns. Ein Bildguthaben (z. B. ein Willkommensguthaben) kann nur für Bildmodelle verwendet werden, niemals für Videos. Es wird getrennt von Ihrem Guthaben geführt, bei Bildgenerierungen zuerst verwendet und bei einer Rückerstattung wieder dem Bildguthaben gutgeschrieben.
BANK_TRANSFERGuthaben aus einer Banküberweisung (Wire / ACH) oder einer anderen Zahlung außerhalb des Karten-Checkouts, etwa per WeChat Pay oder Alipay. Es wird gutgeschrieben, sobald das Geld eingeht. Der Eintrag erscheint als „Bank-/Offline-Zahlung“ mit Rechnung. Wird eine solche Zahlung rückgängig gemacht, zieht ein negativer Posten den Betrag ab und eine Gutschrift storniert die Rechnung.

Ist etwas unklar oder fehlt etwas? Schreiben Sie an support@cheapergen.com – wir lesen jede Nachricht.