API Flat Lay

L’API Flat Lay de Photoroom transforme automatiquement une photo de vêtement en une photo à plat soignée, vue du dessus, prête pour l’e‑commerce et les marketplaces. C’est l’une des plus de 20 opérations de retouche de l’API Photoroom.

Oui. Avec l’API Photoroom, vous envoyez une photo de vêtement avec flatLay.mode défini sur ai.auto et recevez une image Flat Lay en retour, une image par appel. Les appels peuvent être exécutés en parallèle, dans la limite de requêtes (60 images par minute par défaut). Vous pouvez ainsi connecter l’API à votre catalogue ou à votre parcours d’importation et présenter automatiquement chaque nouveau vêtement à plat.

Avec l’API Photoroom, envoyez une photo d’un vêtement et recevez en retour une image Flat Lay nette, vue du dessus, prête pour l’e‑commerce et les marketplaces, sans avoir à mettre en scène, disposer et photographier les vêtements à la main. Les appels sont exécutés en parallèle, à raison de 60 images par minute par défaut, ce qui permet de traiter un catalogue entier en un seul appel.

Pour les catalogues de vêtements, l’API Flat Lay de Photoroom est conçue pour traiter de gros volumes. Une seule intégration met à plat chaque photo de vêtement et vous donne accès à plus de 20 autres retouches, comme la suppression de fond, Mannequin Invisible et Repassage IA. Les forfaits Enterprise offrent des limites de requêtes plus élevées et des contrôles des résultats pour les grands catalogues : contactez notre équipe commerciale.

Flat Lay présente le vêtement à plat et le montre vu d’en haut. Mannequin Invisible présente les vêtements sans mannequin, en faisant ressortir leur coupe et leur tombé, et Virtual Model transforme les photos de vêtements en images lifestyle mettant en scène des mannequins IA prédéfinis ou personnalisés. Ces trois solutions utilisent la même API Photoroom : une seule intégration suffit donc pour les trois.

Obtenez votre clé API, puis envoyez votre photo de vêtement avec flatLay.mode défini sur ai.auto :

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form flatLay.mode=ai.auto \
  --output result.png

Tous les paramètres se trouvent dans la documentation de Flat Lay.

Envoyez chaque photo de vêtement via le même appel à l’API Photoroom, avec les mêmes paramètres. Voici les paramètres que vous pouvez modifier :

• flatLay.mode: définissez-le sur ai.auto pour utiliser Flat Lay.

• flatLay.size : la taille et le rapport hauteur/largeur de l’image générée. La valeur par défaut est SQUARE_HD. Les autres valeurs sont PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 et LANDSCAPE_HD_16_9.

• flatLay.prompt : un prompt textuel facultatif pour guider le style de génération, par exemple une composition à plat épurée en studio.

Envoyez des fichiers PNG, JPEG, WEBP ou AVIF jusqu’à 30 Mo et 5 000 pixels sur le côté le plus large, et recevez des fichiers dans les mêmes formats. Flat Lay renvoie par défaut des images en 1K (1024 x 1024) ; la sortie en 2K et 4K est disponible avec les forfaits Enterprise. Pour plus de détails, consultez la documentation sur la taille, la résolution et le format des fichiers.

Flat Lay est inclus dans le forfait Plus API, à 100 $ par mois (0,10 $ par image), ainsi que dans les forfaits Enterprise : contactez notre équipe commerciale. Chaque appel coûte 0,10 $ et peut inclure autant d’options de modification que nécessaire, sans incidence sur le prix. Les appels qui renvoient une erreur ne consomment pas d’image. Vous pouvez d’abord tester l’API de retouche d’image en mode sandbox, avec 1 000 appels gratuits avec filigrane par mois. Vous trouverez plus de détails sur la page des tarifs.

Oui. Photoroom dispose d’un serveur MCP pour les assistants IA comme Claude, notamment pour Flat Lay : consultez Photoroom MCP pour en savoir plus.

Vous rencontrez des difficultés avec l’API ? Rejoignez notre communauté autour de l’API pour obtenir de l’aide de nos ingénieurs, ou consultez la page de dépannage pour les problèmes courants.

Pour toute question liée à la facturation ou impliquant des informations sensibles, envoyez un message privé directement à Photoroom dans la communauté. Nous serons ravis de vous aider.