API-Referenz
Grenzen
Ratenbegrenzungen, Bildbegrenzungen, Zeitüberschreitungen und Geschwindigkeit.
Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.
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 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 |