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

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://pedraimages.s3.eu-west-3.amazonaws.com/<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

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é par un ciel bleu net. N'affecte que les pixels du ciel — le reste de l'image reste intact.

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.

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"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<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".

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.