API-Einrichtung

Um mit der Fit-it-on Entwickler-API zu interagieren, müssen Sie Ihre Anfragen mithilfe eines sicheren Entwickler-API-Schlüssels authentifizieren.

API-Schlüssel generieren

Melden Sie sich in Ihrem Fit-it-on Dashboard an.
Navigieren Sie in der linken Seitenleiste zu Entwickler > API-Schlüssel.
Klicken Sie auf die Schaltfläche Neuen Schlüssel generieren.
Kopieren Sie Ihren neuen geheimen Schlüssel (er beginnt immer mit fio_sk_...).

Bewahren Sie diesen Schlüssel sicher auf! Aus Sicherheitsgründen können Sie diesen Schlüssel nach dem Schließen des Generierungsdialogs nicht erneut einsehen. Wenn Sie ihn verlieren, müssen Sie ihn widerrufen und einen neuen generieren.

Authentifizierung

Alle API-Anfragen müssen Ihren API-Schlüssel im Authorization-Header als Bearer-Token enthalten.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

Asynchroner Workflow

Die Fit-it-on Generierungs-Endpunkte (wie /v1/run) arbeiten asynchron. Das bedeutet, dass Ihre ursprüngliche Anfrage sofort mit einer Job-Tracking-ID zurückkehrt, anstatt auf den Abschluss der Generierung zu warten.

Schritt 1: Job einreichen

Senden Sie eine POST-Anfrage an https://fititon.app/api/v1/run, um einen Generierungsjob in die Warteschlange zu stellen. Sie erhalten eine sofortige Antwort:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Schritt 2: Ergebnisse abfragen

Verwenden Sie die zurückgegebene id, um den Status Ihrer Generierung regelmäßig zu überprüfen, indem Sie eine GET-Anfrage an https://fititon.app/api/v1/status/{id} senden.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

Die Antwort zeigt den aktuellen Status Ihres Jobs an. Wenn status "completed" ist, enthält das Feld output die URLs der generierten Bilder oder Videos.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

Ihre erste Anfrage stellen

Sie können Ihren Schlüssel testen, indem Sie Ihre aktuell verbleibenden Entwickler-Credits abrufen und Ihren Plan überprüfen:

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

Bei Erfolg wird ein JSON-Objekt mit Ihrem aktuellen Plan und den verbleibenden Credits zurückgegeben.