# Grenzen

## Ratenbegrenzungen

| Endpunkt | Grenzwert | Bei Überschreitung |
|---|---|---|
| `POST /generate` | 300 Anfragen pro Minute pro API-Schlüssel, 600 pro Minute pro Konto | `429 RATE_LIMITED` mit `Retry-After` |
| Testmodus (`mock=true`) | 30 Anfragen pro Minute und 500 pro Tag pro Konto | `429 RATE_LIMITED` mit `Retry-After` |
| `GET /credits` | 60 Anfragen pro Minute pro API-Schlüssel | `429 RATE_LIMITED` |
| MCP-Tool-Aufrufe | 60 pro Minute pro API-Schlüssel | Fehlerergebnis |
| `DELETE /results/:id`, `DELETE /customers/:id`, `DELETE /batches/:id` | 120 Anfragen pro Minute pro API-Schlüssel | `429 RATE_LIMITED` |
| `GET /results/:id`, `GET /generations/:id`, `GET /batches/:id` | 300 Anfragen pro Minute pro API-Schlüssel | `429 RATE_LIMITED` |
| `POST /generations`, `POST /batches` | Wird auf das Limit von 300 pro Minute angerechnet | `429 RATE_LIMITED` |
| Gleichzeitig ausgeführte asynchrone Jobs | 50 pro Konto (Stapel werden separat behandelt) | `429 TOO_MANY_JOBS` |

Das Generierungslimit dient als Sicherheitsvorkehrung gegen verlorene Schlüssel und außer Kontrolle geratene Schleifen. Bei realen Integrationen wird dieses Limit nicht erreicht. Bei sehr hohem Dauervolumen [kontaktieren Sie uns bitte](/contact) vor dem Start, damit die Kapazität entsprechend geplant werden kann.

## Bilder

| Grenzwert | Wert |
|---|---|
| Formate | JPEG, PNG, WebP, HEIC (Prüfung anhand des Inhalts, nicht anhand des Dateinamens) |
| Maximale Größe | 15 MB pro Bild |
| `garment_url` | Öffentliche `https`-URL auf Port 443 oder 80. Interne, private und Cloud-Metadaten-Adressen werden blockiert, auch über Weiterleitungen. |
| Ausgabe | Ein PNG-Bild pro Anfrage, etwa 1 Megapixel (die „1K“-Klasse), zugeschnitten auf das Porträtfoto. Höhere Auflösungen werden derzeit noch nicht angeboten. |

## Zeit

|  |  |
|---|---|
| Typische Erzeugung | Medianwert ca. 19 Sekunden, 90 % innerhalb von ca. 24 Sekunden (Produktionsdaten der letzten 30 Tage) |
| Maximale Anforderungsdauer | 120 Sekunden. Stellen Sie das Client-Timeout auf 120 Sekunden ein. |
| Wiederkehrende Kleidungsstücke | Die Kleideranalyse wird 30 Tage lang zwischengespeichert, sodass bei einer erneuten Anprobe desselben Kleidungsstücks etwa 2 Sekunden Vorbereitungszeit eingespart werden. |

## Guthaben

|  |  |
|---|---|
| Kaufen | Jede Menge zwischen 50 und 100.000 pro Bestellung |
| Ablauf | Niemals |
| Fehlgeschlagene Anproben | Wird automatisch erstattet |
| Monatliches Limit pro Schlüssel | Optional, wird beim Erstellen des Schlüssels festgelegt. Zählt diesen Kalendermonat (UTC); danach erhält der Schlüssel den Status `402 KEY_LIMIT_REACHED`, bis zum 1. |
| Ablauf des Schlüssels | Optionales Datum; der Schlüssel funktioniert nach diesem Tag (UTC) nicht mehr |

## Asynchrone Aufträge und Stapelverarbeitung

|  |  |
|---|---|
| Losgröße | Bis zu 500 Artikel (10 im Testmodus) |
| Ergebnisse | 7 Tage lang aufbewahrt, dann gelöscht |
| Webhook-Antwort | Antworte innerhalb von 8 Sekunden mit `2xx`; bei anderen Antworten wird der Versuch bis zu einem Tag lang wiederholt. |
| Webhook-URLs | Öffentliches `https` auf dem Standardport; Weiterleitungen werden nicht verfolgt |
| Webhook testen | Bis zu 5 pro Minute über das Dashboard |
