API Social Studio | Documentation Développeur Fit It On

Appliquez des effets créatifs et des modèles hautement stylisés aux images de mode pour les médias sociaux.

Le point de terminaison Social Studio applique des modèles esthétiques créatifs et hautement stylisés à vos images de mode, les transformant en contenu accrocheur parfaitement adapté au marketing sur les médias sociaux.

Nom du modèle : social-studio

Cycle de vie : stable

Temps de traitement : ~15s–30s

Format de sortie : Auto (JPEG ou PNG)

Méthodes de livraison : URL

Crédits : 2 à 5 par génération (dépend de la qualité)

Requête

Soumettez votre image et l'ID de style sélectionné 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": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Réponse

Étant donné que la génération d'images 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 en utilisant cet id pour récupérer l'image finale. 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": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Lorsque la tâche est terminée (status: "success"), le champ output contiendra un tableau des URL résultantes :

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Paramètres de requête

Paramètres requis

personImageRequiredstring

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

Conseil de pro : Les photos en pied où la personne entière est visible produisent les meilleurs résultats stylisés. La visibilité claire du visage est importante — l'IA utilise les traits du visage pour créer votre version stylisée. Évitez les photos de groupe ou les images où vous êtes partiellement caché derrière des objets.

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,...). Bien que personImage accepte les chaînes Base64, nous recommandons fortement d'utiliser des URL HTTP standard pour les images de plus de 3 Mo afin d'éviter d'atteindre les limites globales de taille de charge utile JSON (HTTP 413) sur votre requête.

styleIdRequiredstring

L'ID de style photographique à appliquer à l'image générée. Cela détermine l'éclairage, l'esthétique et l'ambiance.

Styles disponibles :

Style Name	Style ID (`styleId`)

Paramètres optionnels

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

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

sampleCountinteger

Nombre de variations d'image à générer par requête. Doit être compris entre 1 et 4. Par défaut : 1

ratiostring

Remplacement du rapport d'aspect. Si vide, le système utilise par défaut 1:1 (idéal pour Instagram/flux sociaux).

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 dépend du niveau de quality de sortie choisi multiplié par le sampleCount.

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

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