Amélioration d'images

API d'amélioration d'images

Amélioration automatique, correction de perspective, remplacement de ciel et floutage — endpoints pour nettoyer les photos immobilières.

Les endpoints d'amélioration d'images corrigent les problèmes courants des photos d'annonces : éclairage terne, perspective inclinée, ciels gris et contenu sensible à la vie privée. Chacun accepte une URL d'image et renvoie le résultat traité.

Amélioration automatique

POST/api/enhance

Améliore automatiquement l'éclairage, l'équilibre des couleurs, la netteté et le contraste. Utilisez-le comme passe de nettoyage par défaut sur les photos d'annonces brutes.

Exemples d'amélioration d'images
De vraies photos d'annonces avant et après la passe d'amélioration — pièces sombres, couleurs ternes, mise au point molle.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo à améliorer, ou un URI data base64.
highFidelityboolean
Amélioration non générative : ajuste uniquement la lumière et la netteté, en conservant les couleurs, les matériaux, la taille des objets et le cadrage exactement comme dans la photo d'origine. Idéal lorsque le résultat doit rester fidèle à l'original.
Default: false
preserveAspectRatioboolean
Par défaut, le résultat est renvoyé à la taille produite par le modèle d'IA, qui peut ne pas correspondre au rapport d'aspect ni à la résolution de votre photo. Définissez-le sur true pour obtenir le résultat à la largeur et à la hauteur exactes de l'image d'entrée : il est recadré depuis le centre au rapport d'aspect d'origine (jamais étiré) puis redimensionné à la résolution d'origine.
Default: false
propertyIdstring
Id optionnel de la propriété (de list_properties ou create_property) à laquelle appartient cette photo. Si renseigné, le résultat est enregistré dans la galerie de cette propriété — visible et modifiable depuis l'app — au lieu d'être seulement renvoyé sous forme d'URL. La réponse inclut alors aussi <code>source</code> (<code>imageId</code> et <code>name</code>) de la photo d'origine, si elle est déjà dans cette propriété ou si vous envoyez aussi <code>name</code>.
namestring
Nom optionnel pour la photo d'origine (par ex. son nom de fichier), jusqu'à 200 caractères. Nécessite <code>propertyId</code>. Si la photo n'est pas encore dans cette propriété, elle y est enregistrée sous ce nom dans le même appel, sans passer d'abord par <code>add_images_to_property</code>, et le nom est renvoyé comme <code>source.name</code>. Une photo déjà présente dans la propriété garde son nom. Jamais affiché sur l'image.

Requête d'exemple

curl -X POST https://app.pedra.ai/api/enhance \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/listing-photo.jpg",
    "highFidelity": true
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Temps de réponse : ~10 secondes par image. La réponse peut inclure plusieurs URLs lorsque le modèle produit des variantes.

Améliorer + corriger la perspective

POST/api/enhance_and_correct_perspective

Comme /api/enhance mais avec une passe de correction de perspective en amont qui redresse les lignes verticales. Utilisez-le quand les photos d'annonce ont été prises avec un téléphone incliné.

Exemples d'amélioration d'images
Même galerie que /api/enhance — la correction de perspective est plus visible sur les extérieurs inclinés.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo, ou un URI data base64.
highFidelityboolean
Amélioration non générative avec correction de perspective : ajuste uniquement la lumière, la netteté et la perspective, en conservant les couleurs, les matériaux et la taille des objets exactement comme dans l'original.
Default: false
preserveAspectRatioboolean
Par défaut, le résultat est renvoyé à la taille produite par le modèle d'IA, qui peut ne pas correspondre au rapport d'aspect ni à la résolution de votre photo. Définissez-le sur true pour obtenir le résultat à la largeur et à la hauteur exactes de l'image d'entrée : il est recadré depuis le centre au rapport d'aspect d'origine (jamais étiré) puis redimensionné à la résolution d'origine.
Default: false
propertyIdstring
Id optionnel de la propriété (de list_properties ou create_property) à laquelle appartient cette photo. Si renseigné, le résultat est enregistré dans la galerie de cette propriété — visible et modifiable depuis l'app — au lieu d'être seulement renvoyé sous forme d'URL. La réponse inclut alors aussi <code>source</code> (<code>imageId</code> et <code>name</code>) de la photo d'origine, si elle est déjà dans cette propriété ou si vous envoyez aussi <code>name</code>.
namestring
Nom optionnel pour la photo d'origine (par ex. son nom de fichier), jusqu'à 200 caractères. Nécessite <code>propertyId</code>. Si la photo n'est pas encore dans cette propriété, elle y est enregistrée sous ce nom dans le même appel, sans passer d'abord par <code>add_images_to_property</code>, et le nom est renvoyé comme <code>source.name</code>. Une photo déjà présente dans la propriété garde son nom. Jamais affiché sur l'image.

Format de réponse : identique à /api/enhance (tableau). Temps de réponse : ~15 secondes par image.

Remplacement de ciel

POST/api/sky_blue

Remplace un ciel gris, couvert ou délavé et améliore l'éclairage. Par défaut un ciel bleu net ; utilisez skyStyle pour choisir un autre moment de la journée (lever, coucher de soleil, nuit).

Exemples d'amélioration d'images
Extérieurs nuageux transformés en photos d'annonces au ciel bleu limpide.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo extérieure, ou un URI data base64.
skyStylestring
Quel ciel et quel éclairage appliquer. Par défaut "sunny". Options : "sunny" (ciel bleu clair et lumineux), "sunny-no-reflections" (ciel bleu avec lumière douce et uniforme — idéal pour les extérieurs ombragés ou orientés au nord), "sunrise" (matin doré et chaleureux), "dawn" (tons de coucher de soleil / crépuscule), "night" (crépuscule avec éclairage intérieur et de façade chaleureux).
Values: sunny sunny-no-reflections sunrise dawn night
Default: sunny
preserveAspectRatioboolean
Par défaut, le résultat est renvoyé à la taille produite par le modèle d'IA, qui peut ne pas correspondre au rapport d'aspect ni à la résolution de votre photo. Définissez-le sur true pour obtenir le résultat à la largeur et à la hauteur exactes de l'image d'entrée : il est recadré depuis le centre au rapport d'aspect d'origine (jamais étiré) puis redimensionné à la résolution d'origine.
Default: false
propertyIdstring
Id optionnel de la propriété (de list_properties ou create_property) à laquelle appartient cette photo. Si renseigné, le résultat est enregistré dans la galerie de cette propriété — visible et modifiable depuis l'app — au lieu d'être seulement renvoyé sous forme d'URL. La réponse inclut alors aussi <code>source</code> (<code>imageId</code> et <code>name</code>) de la photo d'origine, si elle est déjà dans cette propriété ou si vous envoyez aussi <code>name</code>.
namestring
Nom optionnel pour la photo d'origine (par ex. son nom de fichier), jusqu'à 200 caractères. Nécessite <code>propertyId</code>. Si la photo n'est pas encore dans cette propriété, elle y est enregistrée sous ce nom dans le même appel, sans passer d'abord par <code>add_images_to_property</code>, et le nom est renvoyé comme <code>source.name</code>. Une photo déjà présente dans la propriété garde son nom. Jamais affiché sur l'image.

Requête d'exemple

curl -X POST https://app.pedra.ai/api/sky_blue \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/exterior-photo.jpg",
    "skyStyle": "sunny"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Temps de réponse : ~10 secondes par image. Note : ici, output est un objet unique, pas un tableau.

Flouter des objets

POST/api/blur

Floute automatiquement le contenu sensible comme les visages, plaques d'immatriculation ou logos. Utile pour les photos extérieures conformes aux portails.

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo source.
objectsToBlurstringobligatoire
Liste séparée par des virgules de ce qu'il faut flouter. Exemples : "faces", "license plates", "logos", "faces, license plates".
preserveAspectRatioboolean
Par défaut, le résultat est renvoyé à la taille produite par le modèle d'IA, qui peut ne pas correspondre au rapport d'aspect ni à la résolution de votre photo. Définissez-le sur true pour obtenir le résultat à la largeur et à la hauteur exactes de l'image d'entrée : il est recadré depuis le centre au rapport d'aspect d'origine (jamais étiré) puis redimensionné à la résolution d'origine.
Default: false
propertyIdstring
Id optionnel de la propriété (de list_properties ou create_property) à laquelle appartient cette photo. Si renseigné, le résultat est enregistré dans la galerie de cette propriété — visible et modifiable depuis l'app — au lieu d'être seulement renvoyé sous forme d'URL. La réponse inclut alors aussi <code>source</code> (<code>imageId</code> et <code>name</code>) de la photo d'origine, si elle est déjà dans cette propriété ou si vous envoyez aussi <code>name</code>.
namestring
Nom optionnel pour la photo d'origine (par ex. son nom de fichier), jusqu'à 200 caractères. Nécessite <code>propertyId</code>. Si la photo n'est pas encore dans cette propriété, elle y est enregistrée sous ce nom dans le même appel, sans passer d'abord par <code>add_images_to_property</code>, et le nom est renvoyé comme <code>source.name</code>. Une photo déjà présente dans la propriété garde son nom. Jamais affiché sur l'image.

Requête d'exemple

curl -X POST https://app.pedra.ai/api/blur \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/photo.jpg",
    "objectsToBlur": "faces, license plates"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Temps de réponse : ~10 secondes par image. output est un objet unique.

Suivant

Voir Home staging virtuel pour éditer les meubles et le contenu, ou Créer une vidéo pour générer des vidéos d'annonces à partir de photos.