Faites pivoter la caméra virtuelle pour générer de nouveaux angles de vue de n'importe quelle image de mode.

Génération d'angles

Le point de terminaison de Génération d'angles vous permet de prendre une image existante et de repositionner la caméra virtuelle pour générer de nouveaux angles de vue (par exemple, profils de face, de dos, de côté) tout en préservant le modèle, les vêtements, les textures et l'éclairage.

Nom du modèle : angle-generation

Cycle de vie : stable

Temps de traitement : ~10s–20s

Format de sortie : Auto (JPEG ou PNG)

Méthodes de livraison : URL, Base64 (aperçu)

Crédits : 1 à 5 par angle généré (dépend de la qualité)

Requête

Soumettez votre image et les angles souhaités au point de terminaison universel /v1/run :

POSThttps://fititon.app/api/v1/run

Exemples de requêtes

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Réponse

Étant donné que la génération d'angles peut prendre jusqu'à 20 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 en utilisant 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 réessaierons 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 exactement dans le même ordre que le tableau angleIds 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/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Paramètres de requête

Paramètres obligatoires

imageUrlRequiredstring

L'image source à faire pivoter. Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64.

Conseil de pro : Les photos de face produisent les résultats multi-angles les plus cohérents. Évitez les images sources inclinées ou de profil — les vues de face donnent à l'IA le plus d'informations à exploiter, tandis que les prises de vue inclinées forcent l'IA à halluciner des détails structurels manquants.

Exigence de formatage Lors de la soumission d'une chaîne Base64, elle doit inclure le préfixe URI de données standard (par exemple, data:image/jpeg;base64,...).

angleIdsRequiredarray of strings

Un tableau d'identifiants d'angles que vous souhaitez générer. Les options disponibles sont :

"front" : Vue de face
"back" : Vue de dos
"leftSide" : Côté gauche (90°)
"rightSide" : Côté droit (90°)
"left45" : Gauche 45°
"right45" : Droite 45°

Paramètres optionnels

quality'1k' | '2k' | '4k'

Niveau de résolution de sortie. Par défaut : 1k

ratiostring

Remplacement du rapport d'aspect (par exemple, 16:9, 3:4). Si vide, le système utilise par défaut le rapport d'aspect de l'image originale.

Valeurs prises en charge : '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Erreurs d'exécution

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

Coût des crédits

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

Formule : Coût = CréditsQualité × NombreD'Angles

Niveau de qualité	Crédits par angle
1k (Par défaut)	1
2k	3
4k	5

Exemple : Demander ["back", "leftSide", "rightSide"] en qualité 1k coûte 3 crédits au total. Demander les mêmes 3 angles en qualité 4k coûte 15 crédits au total.