Contrôle de la Pose

Le point de terminaison de Contrôle de la Pose vous permet de prendre une image existante d'un modèle et de générer de nouvelles variations où le modèle adopte une pose corporelle différente. L'IA préserve méticuleusement les traits du visage, les vêtements et l'arrière-plan du modèle.

Requête

Soumettez l'image de votre modèle et une liste des poses souhaitées au point de terminaison universel /v1/run :

Exemples de Requêtes

Vous pouvez repositionner un modèle à l'aide d'une image de référence (modèle) ou d'une description textuelle (personnalisée).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Mains sur les hanches"
               },
               {
                 "type": "custom",
                 "text": "Assis sur une chaise, jambes croisées"
               }
             ]
           }
         }'

Réponse

Étant donné que la génération peut prendre jusqu'à 30 secondes, le point de terminaison /v1/run renvoie immédiatement un statut 201 Created avec un id de tâche asynchrone. Vous devez interroger l'API de statut à l'aide de GET /v1/status/{id} pour récupérer les résultats finaux. Alternativement, vous pouvez configurer des webhooks pour recevoir des notifications automatiquement. Veuillez noter que notre répartiteur de webhooks applique un délai d'attente strict de 15 secondes. Votre serveur doit accuser réception du webhook avec un code de statut 2xx dans les 15 secondes, sinon nous le considérerons comme échoué et le retenterons plus tard.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Une fois que le status passe à "succeeded", le champ output contiendra un tableau d'URL pointant vers vos images générées. Les images sont renvoyées dans le même ordre exact que le tableau poses fourni dans votre requête initiale :

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Paramètres de Requête

Paramètres Obligatoires

Modèles de Pose Officiels

Bien que vous puissiez fournir vos propres images de référence via cdnUrl, nous proposons un répertoire organisé de modèles de pose hautement optimisés. Cliquez sur n'importe quelle URL ci-dessous pour prévisualiser la pose.

Paramètres Facultatifs

Erreurs d'Exécution

Les erreurs d'exécution pour cette fonctionnalité utilisent l'ensemble partagé documenté dans Gestion des Erreurs. Si une erreur survient pendant le traitement, le status sera mis à jour à "error" et le champ error contiendra la raison spécifique de l'échec.

Coût en Crédits

Pour les requêtes API Développeur, le coût évolue linéairement en fonction du nombre de poses demandées, et dépend du niveau de quality de sortie choisi.

Formule : Coût = CréditsQualité × NombreDePoses

Exemple : La demande d'un tableau de 3 poses avec une qualité 1k coûte 3 crédits au total. La demande des mêmes 3 poses avec une qualité 4k coûte 15 crédits au total.