Configuration de l'API

Pour interagir avec l'API développeur Fit-it-on, vous devez authentifier vos requêtes à l'aide d'une clé API développeur sécurisée.

Génération d'une clé API

Connectez-vous à votre tableau de bord Fit-it-on.
Accédez à Développeur > Clés API dans la barre latérale gauche.
Cliquez sur le bouton Générer une nouvelle clé.
Copiez votre nouvelle clé secrète (elle commencera toujours par fio_sk_...).

Conservez cette clé en toute sécurité ! Pour des raisons de sécurité, vous ne pourrez pas visualiser cette clé à nouveau après avoir fermé la boîte de dialogue de génération. Si vous la perdez, vous devrez la révoquer et en générer une nouvelle.

Authentification

Toutes les requêtes API doivent inclure votre clé API dans l'en-tête Authorization en tant que jeton Bearer.

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": { ... }
  }'

Flux de travail asynchrone

Les points de terminaison de génération Fit-it-on (comme /v1/run) fonctionnent de manière asynchrone. Cela signifie que votre requête initiale renverra immédiatement un ID de suivi de tâche, au lieu d'attendre la fin de la génération.

Étape 1 : Soumettre une tâche

Effectuez une requête POST vers https://fititon.app/api/v1/run pour mettre en file d'attente une tâche de génération. Vous recevrez une réponse immédiate :

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

Étape 2 : Interroger les résultats

Utilisez l'id renvoyé pour vérifier périodiquement l'état de votre génération en effectuant une requête GET vers https://fititon.app/api/v1/status/{id}.

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

La réponse indiquera l'état actuel de votre tâche. Lorsque status est "completed", le champ output contiendra les URL des images ou vidéos générées.

{
  "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"
}

Effectuer votre première requête

Vous pouvez tester votre clé en récupérant vos crédits développeur restants et en vérifiant votre plan :

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

En cas de succès, cela renverra un objet JSON avec votre plan actuel et vos crédits restants.