API d’édition d’images par IA

L’API de retouche d’image modifie des photos de produits grâce à l’IA en une seule requête. Envoyez une image et indiquez les modifications souhaitées : suppression de fond, Fonds IA, ombres, rééclairage, redimensionnement et bien plus encore. L’image retouchée vous est renvoyée directement. Elle est conçue pour les équipes e‑commerce qui retouchent aussi bien une seule photo qu’un catalogue complet.

Oui. Un seul appel peut supprimer le fond, ajouter une ombre générée par l’IA, définir la marge intérieure, redimensionner et exporter au format dont vous avez besoin. Vous définissez chaque modification comme un paramètre, afin que le même appel fonctionne de la même manière pour chaque image de votre catalogue.

Obtenez une clé API dans le tableau de bord, puis envoyez une requête POST avec votre image. Cet exemple crée un packshot sur fond blanc avec une ombre douce :

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header "x-api-key: $PHOTOROOM_API_KEY" \
  --header "pr-ai-shadows-model-version: 2026-04-15" \
  --form imageFile=@/absolute/path/to/image.jpg \
  --form background.color=FFFFFF \
  --form padding=0.15 \
  --form shadow.mode=ai.auto-with-overrides \
  --form outputSize=1600x1600 \
  --form export.format=jpeg \
  --output result.jpg

Vous pouvez également créer l’appel visuellement dans l’API playground et copier le code généré.

Oui, en exécutant des appels en parallèle. L’API modifie une image par appel et renvoie immédiatement le résultat. Pour traiter un catalogue, envoyez de nombreux appels simultanément depuis un pool de workers. La limite par défaut est de 60 images par minute. Les forfaits Enterprise augmentent cette limite pour les catalogues plus volumineux.

L’API Image Editing fait partie du forfait Plus, à 0,10 $ par image. Pour tester gratuitement, utilisez le mode sandbox : ajoutez sandbox_ au début de votre clé API. Vous pouvez effectuer jusqu’à 1 000 appels gratuits par mois, et les résultats comportent un filigrane. Consultez les tarifs de l’API.

Entrée : PNG, JPEG ou WEBP, jusqu’à 30 MB et 5 000 px sur le côté le plus long. Les images plus grandes sont réduites. Sortie : PNG par défaut, ou JPEG, WEBP ou AVIF. Le format JPEG ne prend pas en charge la transparence : choisissez donc une couleur de fond lors de l’exportation au format JPEG. Consultez la documentation de l’API pour en savoir plus.

Oui. Utilisez le point de terminaison GET et transmettez l’URL publique de l’image comme imageUrl. Il accepte les mêmes paramètres que le point de terminaison POST. Utilisez POST pour les fichiers locaux et GET pour les images déjà hébergées en ligne.

Chaque réponse inclut un score d’incertitude (x-uncertainty-score) compris entre 0 (sûr) et 1 (incertain). Utilisez-le pour signaler automatiquement les images à vérifier. Les forfaits Enterprise incluent la QA visuelle, qui évalue chaque résultat au regard de vos critères de qualité. Vous ne payez que pour les images qui satisfont à ces critères.

Oui. Connectez le MCP Photoroom à Claude dans Paramètres > Connecteurs > Ajouter un connecteur personnalisé, à l’aide de https://mcp.photoroom.com/mcp. Demandez ensuite des modifications en anglais courant. Il fonctionne avec les forfaits Claude payants dans Claude, Cowork et Claude Code, utilise les mêmes crédits que l’API et permet de modifier jusqu’à 20 images par conversation.

Consultez la documentation de l’API et la page de dépannage, ou posez vos questions à nos ingénieurs dans la communauté API. Pour toute question concernant la facturation ou tout sujet sensible, écrivez directement à Photoroom dans la communauté.