# Schnellstart

Ihre erste Anprobe in fünf Minuten.

## 1. Einen API-Schlüssel anfordern

1. [Kostenlos registrieren](/signup). 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

- [Ausführliche Beispiele](/docs/examples) in Node.js, Next.js, Python und PHP
- [Fehler](/docs/errors) und wann ein erneuter Versuch unternommen werden sollte
- [Asynchrone Aufträge, Batches und Webhooks](/docs/async) für lange Aufträge und Katalogarbeit
- Erstellen Sie unter **API Keys** einen Schlüssel pro App oder Umgebung, optional mit monatlichem Guthabenlimit
- [Kaufen Sie Guthaben,](/pricing#developer-api) sobald Sie bereit sind, live zu gehen
