Credits werden zwischen App und API geteilt. Ein Bild, das du über die API
generierst, kostet genau so viel wie dasselbe Bild in der App, und beide ziehen
vom selben Organisationsguthaben ab. Prüfe jederzeit mit
GET /credits, was ein Key ausgeben kann.Bildgenerierung
Bildgenerierung kostet 5 Credits pro output bei1K, skaliert nach Auflösung
und multipliziert mit der Anzahl der outputs:
num_outputs ist standardmäßig 1 (der App-Default ist 4). Zum Beispiel kosten
4 outputs bei 2K 5 × 4 × 2 = 40 Credits.
Magic Edit
Ein Magic Edit (POST /images/edits) kostet 5 Credits pro Edit bei der
Basisauflösung. Wenn die gewählte Engine höhere Auflösungsstufen bietet, gelten
dieselben 1K/2K/4K-Multiplikatoren wie bei der Bildgenerierung, und mehrere
outputs multiplizieren die Kosten auf die gleiche Weise. Engines mit fester
Auflösung werden immer mit den 5 Basis-Credits pro output abgerechnet.
Bildoperationen
Die sechs Bildoperationen — img2img, Variationen, Resize, Upscale, Hintergrundentfernung und Vektorisierung — ziehen jeweils bei der Übermittlung Credits ab und geben den genauen Betrag alsestimated_credits im 202 zurück (er
entspricht dem abgezogenen Betrag).
Der Auflösungs-Multiplikator ist derselbe wie bei der Bildgenerierung:
1K ×1, 2K
×2, 4K ×4. num_outputs ist standardmäßig 1. Img2img und Resize erwarten eine
explizite resolution; Variationen erben die Auflösungsstufe des Quellbilds (es
gibt keinen resolution-Parameter) — eine Quelle ohne ermittelbare Abmessungen wird
mit 1K berechnet.
Upscale
Upscale wird nach der Zielauflösungsstufe berechnet, multipliziert mit dem Credit-Multiplikator des Modells. SeedVR und Crystal sind ×1; Magnific Creative und Magnific Precision sind ×3.
† Bei Crystal werden
14K und höher nach Ausgabe-Megapixeln berechnet (siehe
unten), nicht nach diesem festen Wert — die 14K/16K-Werte in der ×1-Spalte sind der
SeedVR-Preis. Bis 12K entspricht Crystal genau der ×1-Spalte.
Die Magnific-Spalte zeigt den Stufenpreis dort, wo das Modell die Stufe erreichen
kann — die Magnific-Engines erzwingen modellspezifische Ausgabegrenzen, daher sind
die höchsten Stufen nur mit Crystal erreichbar. Auflösungsklassen über
16K
(20K–38K) sind nur mit Crystal verfügbar.12K (14K und höher) nach den
vorhergesagten Ausgabe-Megapixeln statt nach der Stufentabelle berechnet:
Durchgerechnetes Beispiel — Crystal bei 14K
Ein Crystal-Upscale mit einer vorhergesagten Ausgabe von 101,6 MP (ein
14K-klassiges 16:9-Bild) kostet ceil(101.6 × 0.6 / 5) × 5 = ceil(12.19) × 5 =
65 Credits.Cache-Treffer kosten nichts
Hintergrundentfernung und Vektorisierung werden pro Quellbild gecacht. Wenn die Quelle eine dir gehörendeimage_id ist und bereits ein passendes Ergebnis
existiert, gibt die Übermittlung sofort 202 mit status: "completed" und
estimated_credits: 0 zurück — es läuft kein neuer Job und das
Concurrency-Limit deiner Organisation wird nicht belegt.
Jeder andere Fall (eine https-url- oder base64-Quelle oder ein eigenes Bild
ohne fertiges Ergebnis) ist der normale, berechnete Pfad.
Ein Resize, dessen Zielverhältnis bereits der Quelle entspricht (nichts Neues zum
Outpainten) und der keinen
prompt hat, überspringt das Modell, gibt die
zusammengeführte Komposition zurück und erstattet die ungenutzten outputs — er
wird trotzdem completed.Modellerstellung
Die Erstellung eines eigenen Modells (POST /models) kostet 0 Credits — es ist
eine abrechenbare Aktion, die für deinen Audit-Trail erfasst, aber mit null
berechnet wird. Berechnet wird dir das Generieren mit dem Modell, nicht dessen
Erstellung.
Das Legacy-LoRA-„Training” ist veraltet und über die API nicht verfügbar — die
Legacy-Trainings-Endpoints geben
410 Gone zurück. „Modellerstellung” und
„Modelltraining” bezeichnen denselben Gemini-basierten Flow; siehe die
Übersicht dazu, was du bauen kannst.Videogenerierung
Video wird mit einer Basis von 5 Credits pro Sekunde abgerechnet, dann skaliert nach Engine, Auflösung und ob Audio generiert wird:Engine-Multiplikatoren
Dieengine, die du wählst, legt den Basis-Multiplikator fest. Manche Engines
generieren zusätzlich Audio, mit einem zusätzlichen Multiplikator, der obendrauf
angewendet wird.
„inklusive” bedeutet, dass Audio ohne zusätzliche Credit-Kosten generiert wird
(×1.0). Ein „—” bedeutet, dass die Engine keine Audio-Option hat. Lass
engine
weg, um den Default veo_3_1_lite zu verwenden.Auflösungs-Multiplikatoren
Bei Engines, die Auflösungsstufen bieten, kosten höhere Auflösungen mehr:Durchgerechnete Beispiele
Kling 2.5 Pro Turbo · 5s
5 × 5 × 2 = 50 Credits (feste Auflösung, kein Audio).Veo 3.1 Lite · 8s · 1080p
5 × 8 × 1 × 2 = 80 Credits (kein Audio).Veo 3.1 · 8s · 1080p · Audio
5 × 8 × 5 × 2 × 1.25 = 500 Credits.MiniMax 01 · 5s
5 × 5 × 1 = 25 Credits (feste Auflösung, kein Audio).Refunds
Wenn ein Job auf Samsas Seite fehlschlägt — ein terminaler Provider-Fehler, nachdem Credits abgezogen wurden — werden die Credits automatisch an denselben Organisations-Pool zurückerstattet, aus dem sie gezogen wurden. Einfailed-Job, den du korrekt eingereicht hast, kostet dich keine Credits.
(Client-Fehler wie 422 validation_error werden abgelehnt, bevor irgendetwas
berechnet wird.)
Wenn dir die Credits ausgehen
Wenn der Stand, den der Key ausgeben kann, die Kosten einer Aktion nicht decken kann, gibt die Submit-Anfrage402
zurück, bevor irgendein Job erstellt wird — es wird nichts berechnet und es
existiert keine Job-Zeile.
insufficient_credits— der Stand liegt unter den Kosten, und die Organisation hat keine aktiven Teams (oder ist eine vom Team-Budgeting ausgenommene System-Organisation); außerdem der Fallback, wenn die Abbuchung selbst operativ fehlschlägt, unabhängig vom Regime — wiederhole, bevor du von einem zu niedrigen Stand ausgehst. Lade auf oder upgrade.insufficient_team_credits— dasselbe für einen Key, der einem Team mit eigenem Budget zugewiesen ist. Erhöhe das Budget, weise den Key neu zu oder lade auf.insufficient_unallocated_credits— dasselbe für einen Key, der keinem Team mit Budget zugewiesen ist. Gib nicht zugewiesene Credits frei, weise den Key einem Team mit Spielraum zu oder lade auf.subscription_inactive— die Organisation hat kein nutzbares Abonnement. Reaktiviere die Abrechnung.
GET /credits meldet den Stand, den ein Key
ausgeben kann (available), und den Budget-Scope, der bestimmt, welchen der drei
Codes er bekommt.
Credits und Top-ups kaufen
Kaufe Credits, füge Top-ups hinzu und verwalte deinen Plan in der Samsa-App. Die
API-Nutzung zieht vom selben Guthaben ab.