API-Grundlagen

Die Fit-it-on Developer API bietet programmatischen Zugriff auf unsere KI-Generierungsmodelle. Sie folgt standardmäßigen REST-Architekturstilen, verwendet vorhersagbare ressourcenorientierte URLs und akzeptiert JSON-kodierte Anfragekörper.

Asynchrone Ausführung

Alle Bildgenerierungen werden asynchron verarbeitet. Hochauflösende KI-Renderings (2k oder 2048x2048 Samples) benötigen Zeit, und eine synchrone Verbindung würde unweigerlich zu einem Timeout führen.

1. Job einreichen: Sie senden eine POST /v1/run-Anfrage mit Ihren Eingabedaten.
2. ID erhalten: Die API gibt sofort einen 200 OK-Status mit einer prediction_id zurück.
3. Status abfragen: Sie rufen regelmäßig GET /v1/status/{predictionId} auf.
4. Abschluss: Wenn der Status zu succeeded wechselt, sind die URLs zu Ihren generierten Bildern im output-Array verfügbar.

Basis-URL

Alle Anfragen müssen über HTTPS an unsere Produktionsumgebung gesendet werden:

https://fititon.app/api

Inhaltstypen

Alle POST- und PATCH-Anfragen müssen den folgenden Header enthalten, um das Payload-Format anzugeben:

Content-Type: application/json

Die API gibt auch alle Antworten ausschließlich im JSON-Format zurück.

Webhooks

Wenn Sie eine webhook_url im Stamm Ihrer JSON-Payload angeben, senden wir eine HTTP POST-Anfrage an diese URL, sobald der asynchrone Job abgeschlossen ist (entweder erfolgreich oder mit einem Fehler).

Webhook-Payload-Beispiel:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Anfragelimits & Handhabung

Um Missbrauch zu verhindern, erzwingt die API eine Ratenbegrenzung basierend auf Ihrer aktiven Entwicklerplan-Stufe.

Wenn Sie Ihr Limit überschreiten, erhalten Sie einen 429 Too Many Requests-Fehler. Ihre Anwendung sollte dies elegant handhaben, indem sie ein exponentielles Backoff implementiert.