Search docs

Search the TryOnCloud API docs

API-Referenz

Grenzen

Ratenbegrenzungen, Bildbegrenzungen, Zeitüberschreitungen und Geschwindigkeit.

Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.

Ratenbegrenzungen

EndpunktGrenzwertBei Überschreitung
POST /generate300 Anfragen pro Minute pro API-Schlüssel, 600 pro Minute pro Konto429 RATE_LIMITED mit Retry-After
Testmodus (mock=true)30 Anfragen pro Minute und 500 pro Tag pro Konto429 RATE_LIMITED mit Retry-After
GET /credits60 Anfragen pro Minute pro API-Schlüssel429 RATE_LIMITED
MCP-Tool-Aufrufe60 pro Minute pro API-SchlüsselFehlerergebnis
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 Anfragen pro Minute pro API-Schlüssel429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 Anfragen pro Minute pro API-Schlüssel429 RATE_LIMITED
POST /generations, POST /batchesWird auf das Limit von 300 pro Minute angerechnet429 RATE_LIMITED
Gleichzeitig ausgeführte asynchrone Jobs50 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

GrenzwertWert
FormateJPEG, PNG, WebP, HEIC (Prüfung anhand des Inhalts, nicht anhand des Dateinamens)
Maximale Größe15 MB pro Bild
garment_urlÖffentliche https-URL auf Port 443 oder 80. Interne, private und Cloud-Metadaten-Adressen werden blockiert, auch über Weiterleitungen.
AusgabeEin 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 ErzeugungMedianwert ca. 19 Sekunden, 90 % innerhalb von ca. 24 Sekunden (Produktionsdaten der letzten 30 Tage)
Maximale Anforderungsdauer120 Sekunden. Stellen Sie das Client-Timeout auf 120 Sekunden ein.
Wiederkehrende KleidungsstückeDie Kleideranalyse wird 30 Tage lang zwischengespeichert, sodass bei einer erneuten Anprobe desselben Kleidungsstücks etwa 2 Sekunden Vorbereitungszeit eingespart werden.

Guthaben

KaufenJede Menge zwischen 50 und 100.000 pro Bestellung
AblaufNiemals
Fehlgeschlagene AnprobenWird automatisch erstattet
Monatliches Limit pro SchlüsselOptional, 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üsselsOptionales Datum; der Schlüssel funktioniert nach diesem Tag (UTC) nicht mehr

Asynchrone Aufträge und Stapelverarbeitung

LosgrößeBis zu 500 Artikel (10 im Testmodus)
Ergebnisse7 Tage lang aufbewahrt, dann gelöscht
Webhook-AntwortAntworte 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 testenBis zu 5 pro Minute über das Dashboard