Search docs

Search the TryOnCloud API docs

Los geht’s

Schnellstart

Ihre erste Testversion in fünf Minuten: Schlüssel abrufen, kostenlos testen, generieren.

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

Ihre erste Anprobe in fünf Minuten.

1. Einen API-Schlüssel anfordern

  1. Kostenlos registrieren. Jedes Konto beginnt mit 10 kostenlosen Anproben.
  2. Öffnen Sie Dashboard > API-Schlüssel und erstellen Sie einen Schlüssel. Er beginnt mit tk_dev_v1_ und wird nur einmal angezeigt. Kopieren Sie ihn daher jetzt.
  3. Speichern Sie sie als Umgebungsvariable auf Ihrem Server:
bash
export TRYONCLOUD_API_KEY="tk_dev_v1_your_key_here"

2. Kostenlos im Testmodus ausprobieren

Fügen Sie ?mock=true hinzu. Die Anfrage wird authentifiziert und beide Bilder werden genau wie bei einem echten Aufruf validiert, es wird jedoch nichts generiert und es fallen keine Kosten an. Das Personenbild wird unverändert zurückgegeben.

bash
curl -X POST "https://www.tryoncloud.com/api/v1/generate?mock=true" \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY" \
  -F "garment_image=@shirt.jpg" \
  -F "person_image=@person.jpg" \
  -o mock.png -D -

Achten Sie in den Antwort-Headern auf X-Mock: 1. Verwenden Sie beim Erstellen den Mock-Modus.

3. Eine realistische Anprobe erstellen

?mock=true entfernen:

bash
curl -X POST "https://www.tryoncloud.com/api/v1/generate" \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY" \
  -F "garment_image=@shirt.jpg" \
  -F "person_image=@person.jpg" \
  -o result.png

result.png zeigt den Kunden, der das Kleidungsstück trägt. Ein typisches Ergebnis dauert etwa 20 Sekunden; legen Sie daher für Ihren HTTP-Client ein Timeout von mindestens 120 Sekunden fest.

4. Überprüfen Sie, was Sie noch übrig haben

bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Die besten Fotos für beste Ergebnisse

  • Person: eine Person, Ganzkörperaufnahme, Blick in die Kamera, gute Beleuchtung, nach Möglichkeit einfarbiger Hintergrund.
  • Bekleidung: ein scharfes Produktfoto von der Vorderseite, entweder an einem Model oder flach auf einem einfarbigen Hintergrund.
  • Drapierte Kleidungsstücke (Saris, Dhotis) kommen am besten zur Geltung, wenn das Produktfoto das Kleidungsstück an einem Model drapiert zeigt.

Nächste Schritte