# Preise

Jedes Modell kostet genau das, was sein Anbieter dafür berechnet, in US-Dollar. Du zahlst aus deinem **API-Guthaben**,
das in **API-Credits** angegeben wird: **1.000 API-Credits = 1 $**. Das API-Guthaben ist ein eigenes Guthaben und von den
Credits der Doitong-Apps getrennt. Es gibt keine Pläne, Mindestbeträge oder modellbezogenen Gebühren: Ein Aufruf kostet seinen Preis, der vom
API-Guthaben abgebucht wird, sobald die Anfrage angenommen wurde.

In Russland (doitong.ru, api.doitong.ru oder `?currency=rub`) werden Preise auch in Rubel angezeigt: USD-Preis ×
der USD/RUB-Kurs × 1,3.

## Einheiten

Jedes Modell hat eine Abrechnungseinheit, die auf seiner Seite und in `GET https://api.doitong.com/v1/models/{model_id}` angezeigt wird:

| Einheit | Menge |
|---|---|
| `second` | Sekunden des Ausgabevideos oder -audios (`duration`) |
| `image` | Generierte Bilder (`num_images`) |
| `megapixel` | Breite × Höhe der Ausgabe in Megapixeln (1 MP = 1024 × 1024 Pixel) |
| `video` | Ein generiertes Video |
| `request` | Ein Aufruf |
| `1000_characters` | Zeichen des Eingabetexts pro 1000 |
| `step` | Trainingsschritte |

Preis = Menge × API-Credits pro Einheit, auf einen ganzen API-Credit aufgerundet (0,001 $), mindestens jedoch 1. Sehr günstige
Einheiten können einen Bruchteil pro Einheit kosten (`0.4` API-Credits pro Sekunde); nur die Summe eines Aufrufs wird gerundet.

Einige Modelle berechnen je nach Eingabe einen anderen Tarif: Video mit Ton kostet mehr als ohne, 4K mehr als 1K und so weiter. Diese **Regeln**
sind auf jeder Modellseite aufgeführt. Ein ausgelassener Parameter zählt als sein Standardwert, daher entspricht der angezeigte Preis für eine Eingabe dem tatsächlich gezahlten Preis.

## Exakte, gemessene, geschätzte und nutzungsabhängige Preise

Jeder Preis hat einen `mode`:

- `exact`: Der Preis wird aus deiner Eingabe berechnet (Sekunden, Bilder, Megapixel, Zeichen, Schritte oder ein Pauschalpreis pro Video oder Aufruf).
- `measured`: Der Preis richtet sich nach den gesendeten Dateien: der Länge eines Eingabevideos oder -audios, der Größe eines Eingabebildes,
der Bildrate oder Frame-Anzahl eines Videos. Upscaling, Lippensynchronisation, Video-zu-Video, Transkription und Audio-Tools
werden auf diese Weise bepreist. Vor der Ausführung liest die API die Länge, Auflösung und Bildrate der Datei (das Angebot macht dasselbe), daher entspricht der
Angebotspreis genau den Kosten der Ausführung. Die Modellseite gibt an, wofür du zahlst ("Preis pro Sekunde deines
Eingabevideos"), und ihr Rechner verwendet die Werte deiner Datei. Eine Datei, die nicht gelesen werden kann, wird mit
`unmeasurable_input` abgelehnt, ohne dass Kosten entstehen.
- `estimate`: Die eigenen Kosten des Modells hängen von etwas ab, das die Eingabe nicht im Voraus erkennen lässt (Token, Rechenzeit).
Ein solches Modell berechnet einen festen **geschätzten Preis pro Ausführung** (pro Ausgabebild, wenn es eine Bildanzahl gibt), basierend auf den
durchschnittlichen Kosten echter Ausführungen dieses Modells. Du kennst den Preis weiterhin vor der Ausführung: Der Angebotspreis ist der zu zahlende Preis.
- `metered`: Das Modell wird **nach tatsächlicher Nutzung abgerechnet**, die nur die Ausführung selbst kennt: die Token, die ein Sprach- oder
Bildverarbeitungsmodell liest und schreibt, die Sekunden Sprache, die ein Sprachmodell erzeugt, oder die Verarbeitungszeit des Modells.
Siehe unten [Nach Nutzung abgerechnet](#metered).

Modellseiten nennen "Preis pro Ausführung", "Preis pro Sekunde deines Eingabevideos" (und ähnliche Angaben), "Geschätzter Preis pro Ausführung" oder
"Nach Nutzung abgerechnet"; `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` und `?mode=metered` listet sie auf.

## Nach Nutzung abgerechnet

Ein `metered`-Modell hat einen Nutzungspreis ("$0.01 pro 1000 Token", "$0.002 pro Sekunde erzeugtem Audio", "$0.00111 pro
Sekunde Verarbeitungszeit") und ein **Maximum pro Ausführung**: den höchsten Betrag, den die Ausführung kosten kann, basierend auf deiner Anfrage
(`max_tokens`, der Länge deines Textes, der Auflösung, der Anzahl der Ausgaben) und den veröffentlichten Grenzen des Modells. Es hängt niemals vom Inhalt einer Datei hinter einer URL ab. Bei einem Modell, das nach Verarbeitungszeit oder der Länge einer Sprachsitzung abgerechnet wird, entspricht das Maximum der längsten möglichen Anfrage (15 Minuten für Bilder, 30 für Audio, 60 für Video), und liegt daher weit über einer typischen Ausführung. Eine Eingabe, deren Maximum über dem Limit pro Ausführung des Modells liegen würde (etwa ein sehr langer Text), wird mit `422 invalid_input` abgelehnt:

1. Das Angebot gibt dieses Maximum als `credits` zurück (mit `hold` und `typical`, einer typischen Ausführung). Beim Start der Ausführung wird das Maximum vom API-Guthaben abgebucht; es muss durch das Guthaben und dein Schlüsselbudget gedeckt sein.
2. Wenn die Ausführung erfolgreich ist, wird die Anfrage auf die vom Modell gemeldete Nutzung abgerechnet: Nutzung × Nutzungspreis,
aufgerundet auf einen ganzen API-Credit. **Der übrige Teil des Maximums wird automatisch erstattet**, einmalig als `refund`-Eintrag
im API-Guthaben.
3. Eine Ausführung kostet niemals mehr als ihr Maximum, selbst wenn ihre Nutzung höher wäre. Eine fehlgeschlagene oder abgebrochene Ausführung wird wie immer vollständig erstattet.

Die meisten Ausführungen kosten deutlich weniger als das Maximum; die Modellseite zeigt für die Eingabe des Builders "Bis zu $X pro Ausführung" und die typische Ausführung ("ab" im Katalog). Bei den wenigen Modellen, die nach Verarbeitungszeit abgerechnet werden, entspricht die Nutzung der Verarbeitungszeit des Modells (mit `approximate` gekennzeichnet).

```json 200 OK · Angebot eines metered-Modells
{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}
```

Nach der Ausführung zeigt `cost` der Anfrage, welcher Betrag zurückgehalten wurde und wie hoch die Nutzung war:

```json
{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}
```

`charged − refunded` sind die Kosten der Ausführung. `settled.status` ist in dem kurzen Zeitraum zwischen Ergebnis und Abrechnung `pending` und im seltenen Fall, dass das Modell überhaupt keine Nutzung gemeldet hat, `no_usage` (dann bleibt das Maximum der Preis).

## Angebot vor der Ausführung

`POST https://api.doitong.com/v1/quote/{model_id}` nimmt genau den Body entgegen, den du an `run` senden würdest, und gibt den Preis dieser Eingabe zurück: den exakten Preis, außer bei einem Modell, das [nach Nutzung abgerechnet](#metered) wird; dort ist es der höchste Betrag, den die Ausführung kosten kann. Es benötigt keinen Schlüssel und ist kostenlos:

```bash
curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'
```

```json 200 OK · Angebot
{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}
```

Mit einem Schlüssel gibt das Angebot außerdem `balance_credits` und `balance_usd` (dein API-Guthaben), `affordable` und `key_budget_remaining` zurück. Füge `?currency=rub` für einen `rub`-Betrag hinzu.

> [!TIP]
> **Das Angebot entspricht der Abrechnung.** Dieselbe Funktion berechnet beides, daher kostet eine Ausführung mit dieser Eingabe genau `credits`.
> Die einzige Ausnahme ist ein Modell, das [nach Nutzung abgerechnet wird](#metered) (`mode: metered`): Dort ist `credits` der höchste Betrag, den die Ausführung kosten kann; er wird beim Start abgebucht und der ungenutzte Teil nach der Ausführung erstattet.

## Preisobjekte

Jeder Preis in der API hat dieselbe Struktur:

- Modelle: `price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second",
  "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" }` — zusätzlich `rub`,
  `rub_display` und `from_rub` in Russland oder mit `?currency=rub`;
- Anfragen: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (API-Credits; eine metered-Anfrage
  fügt `mode`, `held`, `typical` und `settled` hinzu, siehe [Nach Nutzung abgerechnet](#metered));
- Konto: `GET https://api.doitong.com/v1/account` gibt `credits` (das API-Guthaben), `balance: { "credits", "usd" }` und
  `storage` (Preis, Nutzung und monatliche Schätzung des Dateispeichers) zurück.

## Erstattungen

- Eine ungültige Anfrage (jeder `4xx`-Fehler vor Beginn der Ausführung) wird niemals berechnet.
- Eine Anfrage, die mit `failed` endet (einschließlich `timeout`), wird automatisch vollständig auf das API-Guthaben erstattet.
- Eine Anfrage, die du vor ihrem Start abbrichst, wird vollständig erstattet. Sobald das Modell generiert, ist ein Abbruch nur eine
  Anfrage: Wenn das Modell fertig wird, wird das Ergebnis geliefert und berechnet.
- Eine erfolgreiche `metered`-Anfrage erhält den Teil ihres Maximums zurück, den sie nicht genutzt hat.

Das Anfrageobjekt zeigt alles: `cost.credits`, `cost.charged` und `cost.refunded`.

## Dateispeicher

Ausgabedateien werden in unserem Speicher aufbewahrt. Du wählst dies im Konto oder pro Ausführung (`?storage=`):

| | Aufbewahrung | Preis |
|---|---|---|
| Dauerhaft (`permanent`, Standard) | Bis du sie löschst | 100 API-Credits (0,10 $) pro GB und Monat |
| 7 Tage (`temporary`) | 7 Tage | Kostenlos |

Dauerhafter Speicher wird einmal täglich vom API-Guthaben abgerechnet: gespeicherte GB × Monatspreis ÷ Anzahl der Tage im Monat, als Ledger-Zeilen mit dem Typ `storage`. Bruchteile eines API-Credits werden auf den nächsten Tag übertragen, sodass ein Monat genau GB × 100 API-Credits ergibt (1 GB = 1024³ Byte; 10 GB, die einen Monat gespeichert werden, kosten 1.000 API-Credits). Das Guthaben fällt niemals unter null: Wenn die Zahlung nicht möglich ist, wird dieser Tag nicht berechnet, du erhältst eine E-Mail und hast 30 Tage zum Aufladen, bevor die gespeicherten Dateien temporär werden und 7 Tage später gelöscht werden. Details: [Dateien](https://doitong.com/developers/docs/files#storage).

## Aktuelle Preise

| Modell | ID | Preis | Ab |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 0,025 $ / Megapixel | 0,025 $ (25 API-Credits) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 0,003 $ / Megapixel | 0,003 $ (3 API-Credits) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 0,012 $ / Megapixel | 0,012 $ (12 API-Credits) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 0,015 $ / Megapixel Ausgabe-Bild | 0,015 $ (15 API-Credits) |
| [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | ab 0,008 $ / Bild | 0,008 $ (8 API-Credits) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | ab 0,03 $ / Bild | 0,03 $ (30 API-Credits) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | ab 0,06 $ / Bild | 0,06 $ (60 API-Credits) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | ab 0,15 $ / Bild | 0,15 $ (150 API-Credits) |
| [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | ab 0,04 $ / Bild | 0,04 $ (40 API-Credits) |
| [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | 0,035 $ / Bild | 0,035 $ (35 API-Credits) |
| [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | ab 0,068 $ | 0,068 $ (68 API-Credits) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 0,04 $ / Bild | 0,04 $ (40 API-Credits) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | ab 0,06 $ / Bild | 0,06 $ (60 API-Credits) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | ab 0,15 $ / Bild | 0,15 $ (150 API-Credits) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | ab 0,04 $ / Bild | 0,04 $ (40 API-Credits) |
| [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | ab 0,0425 $ / Sekunde Ausgabe-Video | 0,043 $ (43 API-Credits) |
| [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | ab 0,08 $ / Sekunde | 0,48 $ (480 API-Credits) |
| [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | ab 0,112 $ / Sekunde | 0,56 $ (560 API-Credits) |
| [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | ab 0,12 $ / Sekunde | 0,72 $ (720 API-Credits) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | ab 0,05 $ / Sekunde | 0,25 $ (250 API-Credits) |
| [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | ab 0,113 $ / Sekunde | 0,452 $ (452 API-Credits) |
| [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | ab 0,141 $ / Sekunde | 0,564 $ (564 API-Credits) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | ab 0,20 $ / Sekunde | 1,60 $ (1.600 API-Credits) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | ab 0,10 $ / Sekunde | 0,80 $ (800 API-Credits) |
| [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | ab 0,05 $ / Sekunde | 0,25 $ (250 API-Credits) |
| [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | ab 0,0425 $ / Sekunde Ausgabe-Video | 0,043 $ (43 API-Credits) |
| [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | ab 0,082 $ / Sekunde | 0,492 $ (492 API-Credits) |
| [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | ab 0,112 $ / Sekunde | 0,56 $ (560 API-Credits) |
| [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | ab 0,12 $ / Sekunde | 0,72 $ (720 API-Credits) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | ab 0,05 $ / Sekunde | 0,25 $ (250 API-Credits) |
| [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | ab 0,113 $ / Sekunde | 0,452 $ (452 API-Credits) |
| [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | ab 0,141 $ / Sekunde | 0,564 $ (564 API-Credits) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | ab 0,10 $ / Sekunde | 0,80 $ (800 API-Credits) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | ab 0,20 $ / Sekunde | 1,60 $ (1.600 API-Credits) |
| [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | ab 0,05 $ / Sekunde | 0,25 $ (250 API-Credits) |
| [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | ab 0,113 $ / Sekunde | 0,452 $ (452 API-Credits) |
| [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | ab 0,141 $ / Sekunde | 0,564 $ (564 API-Credits) |
| [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | 0,115 $ / Sekunde Eingabe-Audio | 0,115 $ (115 API-Credits) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 8,00 $ / Minute Ausgabe-Video | 8,00 $ (8.000 API-Credits) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | ab 0,08 $ / Sekunde Eingabe-Audio | 0,08 $ (80 API-Credits) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 0,08 $ / 24 Megapixel Ausgabe-Bild | 0,08 $ (80 API-Credits) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | ab 0,00667 $ / Sekunde Eingabe-Video | 0,10 $ (100 API-Credits) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | ab 0,018 $ | 0,018 $ (18 API-Credits) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 0,08 $ / 1000 Zeichen | 0,08 $ (80 API-Credits) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 0,10 $ / 1000 Zeichen | 0,10 $ (100 API-Credits) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 0,002 $ / Sekunde | 0,12 $ (120 API-Credits) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 0,001 $ / Sekunde | 0,008 $ (8 API-Credits) |

Dies sind die vorgestellten Modelle. Alle 1.496 Modelle und ihre Preise sind im [Modellkatalog](https://doitong.com/developers/models) und in `GET /models` (kein Schlüssel erforderlich) aufgeführt.

## Aufladen

Zahle unter [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance) Geld auf das API-Guthaben ein. Wenn das Guthaben zu niedrig ist, antwortet eine Ausführung mit
`402 insufficient_credits` und einer `top_up_url`. Jeder API-Schlüssel kann außerdem mit einem eigenen Budget in API-Credits begrenzt werden
(siehe [Authentifizierung](https://doitong.com/developers/docs/authentication#credit-budgets)).
