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.
preserveOriginalFramingboolean
Conserve le rapport d'aspect et le cadrage d'origine exact. Mettez true pour les portails aux spécifications d'image strictes.
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.

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",
    "preserveOriginalFraming": 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.
preserveOriginalFramingboolean
Lorsque true, le pipeline préserve exactement le cadrage, le rapport d'aspect et la résolution d'entrée (sans recadrage des bords). Conçu pour les verticales de vérification où la sortie doit représenter légalement la photo capturée.
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.

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
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.

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".
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.

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.