Anleitungen
API-Änderungsprotokoll
Alle Änderungen an der Entwickler-API, beginnend mit den neuesten.
Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.
Änderungen an der Entwickler-API, beginnend mit den neuesten. Bestehende Anfrage- und Antwortformate werden hier ohne vorherige Ankündigung nicht geändert; neue Felder und Endpunkte werden zusätzlich hinzugefügt.
19. November 2026
- Neu: Asynchrone Testausführungen:
POST /api/v1/generationsgibt sofort einen Auftrag zurück; dieser kann unterGET /api/v1/generations/:idabgerufen werden. Dokumentation - Neu: Stapel von bis zu 500 Anproben anhand von Bild-URLs:
POST /api/v1/batches,GETundDELETE /api/v1/batches/:id(stornierte Artikel werden erstattet). Dokumentation - Neu: Signierte Webhooks
generation.completed,generation.failedundbatch.completed, pro Anfrage (webhook_url) oder als Konto-Endpunkt mit Ereignisauswahl und einem Testereignis unter API-Schlüssel > Webhooks. Dokumentation - Neu: Mit
GET /api/v1/results/:idkönnen Sie ein gespeichertes Ergebnis mit Ihrem Schlüssel abrufen. Asynchrone Ergebnisse werden 7 Tage lang aufbewahrt. - Neu:
DELETE /api/v1/customers/:customer_idlöscht die gespeicherten Ergebnisse und Datensätze eines Endnutzers.customer_idwird bei/generate,/generationsund Batch-Elementen akzeptiert. Dokumentation - Neu: Monatliches Guthabenlimit und Ablaufdatum pro Schlüssel, die bei der Erstellung des Schlüssels festgelegt werden. Überschreitung des Limits:
402 KEY_LIMIT_REACHED. Dokumentation - Neu: Testmodus (
?mock=true) für asynchrone Aufträge und Stapelverarbeitungen (bis zu 10 Elemente), kostenlos. - Schneller: Die Kleideranalyse wird 30 Tage lang zwischengespeichert, sodass bei wiederholten Anproben desselben Produktfotos etwa 2 Sekunden eingespart werden.
- Dashboard: Suche nach Generationen anhand der Kunden-ID oder der Anfrage-ID, Zeitraumsfilter, Live-Ansicht und CSV-Export. Die Übersicht zeigt den Median und die p95-Zeit sowie die Kreditlaufzeit an.
- Sicherheit: Webhooks werden ausschließlich an öffentliche Adressen gesendet, die zum Zeitpunkt der Verbindung überprüft werden; es wird niemals Umleitungen gefolgt.
18. November 2026
- Neu:
Idempotency-Key-Header beiPOST /api/v1/generate; Wiederholungsversuche werden niemals doppelt abgerechnet. Dokumentation - Neu:
X-Request-Idin jeder Antwort (undrequest_idin Fehlertexten) sowieX-RateLimit-LimitundX-RateLimit-Remaining. - Neu: OpenAPI 3.1-Spezifikation unter
https://www.tryoncloud.com/api/v1/openapi.json. - Neu: Zahlen zum öffentlichen Dienst unter
GET /api/v1/statusund auf der Statusseite. - Dokumente: Angegebene Ausgabeauflösung: ca. 1 Megapixel (1K-Klasse).
14. November 2026
- Neu: Webhook-Header
x-tryoncloud-signature-v2, der den Zeitstempel zusammen mit dem Body signiert, sodass alte Zustellungen abgelehnt werden können.x-tryoncloud-signaturebleibt unverändert. Dokumentation - Geändert: Die Ratenbegrenzungen gelten nun für alle Server, mit einer kontoweiten Obergrenze von 600 Generierungsanfragen pro Minute und einer separaten Obergrenze für den Testmodus. Dokumentation
- Neu:
GET /api/v1/credits, um die verbleibenden Testzugriffe mit Ihrem API-Schlüssel zu überprüfen. Dokumentation - Neu: MCP-Server unter
https://www.tryoncloud.com/api/mcpfür Claude Code, Cursor und VS Code. Dokumentation - Neu: JavaScript/TypeScript-SDK. Dokumentation
- Neu: Kostenloser Testmodus,
?mock=trueoderX-Mock: true. Dokumentation - Neu:
DELETE /api/v1/results/:id, um ein gespeichertes Ergebnis vorzeitig zu löschen. Dokumentation - Geändert: Der Preis für Unternehmenskunden (ab 5.000 Testanproben) wurde von 0,08 $ auf 0,07 $ gesenkt. In Indien bleibt der Preis bei 6,50 ₹.
- Geändert: Downloads von
garment_urlwerden nun bei jeder Weiterleitung und zum Zeitpunkt der Verbindungsherstellung überprüft; interne, private und Cloud-Metadaten-Adressen werden abgelehnt. - Dokumente: Neue mehrseitige Dokumente mit Markdown-Versionen aller Seiten, eine Datenverarbeitungsvereinbarung sowie eine Weiterverkaufsgenehmigung in den Nutzungsbedingungen.
12. November 2026
- Geändert: Neue Preise für jede Größenstufe: ab 50 Stück 0,11 $, ab 300 Stück 0,10 $, ab 1.000 Stück 0,09 $, ab 5.000 Stück 0,08 $.
- Neu: Benannte API-Schlüssel, bis zu 5 aktive, Datumsangaben zur letzten Nutzung, einzeln widerrufbar.
5. November 2026
- Geändert:
POST /generategibt immerimage/pngzurück, was dem dokumentiertenContent-Typeentspricht.