> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Preise

> Wie API-Aktionen Credits aus dem Pool deiner Organisation ziehen, mit Kostentabellen für Bilder, Edits, Modelle und Video.

Die Samsa API verwendet **dieselben Credits** wie die App. Jede API-Aktion zieht
aus dem bestehenden Samsa-Credit-Pool deiner Organisation zu den **gleichen
Raten**, die du in der App zahlst — es gibt keine separate API-Preisliste und keine
API-Gebühr pro Sitzplatz.

<Info>
  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 es jederzeit mit
  [`GET /credits`](/de/quickstart) oder `GET /me`.
</Info>

## Bildgenerierung

Bildgenerierung kostet **5 Credits pro output bei `1K`**, skaliert nach Auflösung
und multipliziert mit der Anzahl der outputs:

```
credits = 5 × num_outputs × resolution_multiplier
```

| Auflösung | Multiplikator | Credits pro output |
| --------- | ------------- | ------------------ |
| `1K`      | ×1            | 5                  |
| `2K`      | ×2            | 10                 |
| `4K`      | ×4            | 20                 |

`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.

## 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.

<Note>
  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](/de/) dazu, was du bauen kannst.
</Note>

## Videogenerierung

Video wird mit einer **Basis von 5 Credits pro Sekunde** abgerechnet, dann
skaliert nach Engine, Auflösung und ob Audio generiert wird:

```
credits = round(5 × seconds × engine_multiplier × resolution_multiplier × audio_multiplier)
```

### Engine-Multiplikatoren

Die `engine`, die du wählst, legt den Basis-Multiplikator fest. Manche Engines
generieren zusätzlich Audio, mit einem zusätzlichen Multiplikator, der obendrauf
angewendet wird.

| Engine                | Basis-Multiplikator | Audio        |
| --------------------- | ------------------- | ------------ |
| `veo_3_1_lite`        | ×1                  | +67% (×1.67) |
| `veo_3_1`             | ×5                  | +25% (×1.25) |
| `veo_3_1_fast`        | ×2                  | +50% (×1.5)  |
| `veo_3`               | ×5                  | +25% (×1.25) |
| `veo_3_fast`          | ×2                  | +50% (×1.5)  |
| `veo_2`               | ×4                  | —            |
| `kling_3_0_pro`       | ×2                  | +50% (×1.5)  |
| `kling_2_6_pro`       | ×2                  | +25% (×1.25) |
| `kling_2_5_pro_turbo` | ×2                  | —            |
| `kling_2_0_master`    | ×4                  | —            |
| `seedance_2_0`        | ×4                  | inklusive    |
| `sora_2_pro`          | ×4                  | inklusive    |
| `runway_gen_4`        | ×2                  | —            |
| `hailuo_02`           | ×2                  | —            |
| `minimax_01`          | ×1                  | —            |

<Note>
  „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.
</Note>

### Auflösungs-Multiplikatoren

Bei Engines, die Auflösungsstufen bieten, kosten höhere Auflösungen mehr:

| Engine-Gruppe                                             | Auflösungs-Multiplikatoren                                             |
| --------------------------------------------------------- | ---------------------------------------------------------------------- |
| Veo 3.x, Sora 2 Pro                                       | `720p` ×1 · `1080p` ×2 · `4K` ×3 (wo die Engine die Stufe unterstützt) |
| `veo_3_1_lite`                                            | `720p` ×1 · `1080p` ×2                                                 |
| `seedance_2_0`                                            | `480p` ×0.5 · `720p` ×1 · `1080p` ×2.25                                |
| Kling, `runway_gen_4`, `hailuo_02`, `minimax_01`, `veo_2` | Feste Auflösung — kein Auflösungs-Multiplikator                        |

### Durchgerechnete Beispiele

<CardGroup cols={2}>
  <Card title="Kling 2.5 Pro Turbo · 5s" icon="clapperboard">
    `5 × 5 × 2 = 50` Credits (feste Auflösung, kein Audio).
  </Card>

  <Card title="Veo 3.1 Lite · 8s · 1080p" icon="clapperboard">
    `5 × 8 × 1 × 2 = 80` Credits (kein Audio).
  </Card>

  <Card title="Veo 3.1 · 8s · 1080p · Audio" icon="clapperboard">
    `5 × 8 × 5 × 2 × 1.25 = 500` Credits.
  </Card>

  <Card title="MiniMax 01 · 5s" icon="clapperboard">
    `5 × 5 × 1 = 25` Credits (feste Auflösung, kein Audio).
  </Card>
</CardGroup>

## 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. Ein
`failed`-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 ausgebbare Pool der Organisation die Kosten einer Aktion nicht decken
kann, gibt die Submit-Anfrage [`402`](/de/guides/errors#insufficient_credits)
zurück, **bevor** irgendein Job erstellt wird — es wird nichts berechnet und es
existiert keine Job-Zeile.

* [`insufficient_credits`](/de/guides/errors#insufficient_credits) — der Pool
  liegt unter den Kosten. Lade auf oder upgrade.
* [`subscription_inactive`](/de/guides/errors#subscription_inactive) — die
  Organisation hat kein nutzbares Abonnement. Reaktiviere die Abrechnung.

<Card title="Credits und Top-ups kaufen" icon="credit-card" href="https://app.samsa.ai">
  Kaufe Credits, füge Top-ups hinzu und verwalte deinen Plan in der Samsa-App. Die
  API-Nutzung zieht vom selben Guthaben ab.
</Card>
