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. Der Preis ist auf jeder
Text-to-Image-engine gleich; eine Engine bietet nur die Auflösungen an, die sie
unterstützt (siehe GET /images/models).
Magic Edit
Ein Magic Edit (POST /images/edits) kostet 5 Credits pro output bei der
Basisauflösung, multipliziert mit num_images. Die drei Nano-Banana-Engines haben
Auflösungsstufen mit denselben Multiplikatoren wie die Bildgenerierung; gemini
und kontext haben eine feste Auflösung und kosten immer 5 pro output:
Die
202 gibt den abgebuchten Betrag als estimated_credits zurück, zusammen mit
der effektiven engine und resolution. Siehe
Engines und Credits.
Bild-Uploads
Bild-Uploads (POST /images/uploads/prepare
und POST /images/uploads/{id}/complete sowie die MCP-Tools prepare_image_upload
und complete_image_upload) sind kostenlos. Die Operationen, die du danach auf
dem hochgeladenen Bild ausführst, werden wie üblich 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).Prompt-Verbesserung
Demnächst verfügbar. Die Prompt-Verbesserung ist noch nicht aktiviert, daher wird
heute nichts berechnet. Der Preis unten gilt ab dem Start.
POST /prompts/improve
oder das MCP-Tool improve_prompt) kostet 1 Credit pro Aufruf, für das target
image wie für video. Der Credit wird abgebucht, bevor das KI-Modell läuft, und die
200-Antwort meldet ihn als credits_charged: 1.
- Schlägt der KI-Provider fehl, wird der Credit automatisch erstattet und der Aufruf
gibt
502 provider_errorzurück. - Ein Aufruf, der mit demselben
Idempotency-Keyund Body innerhalb von 24 Stunden wiederholt wird, gibt das gespeicherte Ergebnis zurück und wird nicht erneut berechnet. Ohne den Header wird jeder Aufruf berechnet. Siehe Idempotenz.
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.)
Ein Bild-Job, der
failed mit error delivery_blocked_compliance: <codes>
endet, ist anders: Die outputs wurden erzeugt, aber die Compliance-Pipeline hat sie
zurückgehalten (siehe Compliance-Sperren). Er wird nicht automatisch
zurückerstattet, und sein credits_used bleibt wie abgebucht. Wende dich mit der
Job-id an support@samsa.ai.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.