Mejora de imágenes

API de mejora de imágenes

Mejora automática, corrección de perspectiva, sustitución de cielo y difuminado — endpoints para limpiar fotos inmobiliarias.

Los endpoints de mejora de imágenes corrigen problemas habituales de las fotos de anuncios: iluminación apagada, perspectiva inclinada, cielos grises y contenido sensible a la privacidad. Cada uno acepta una URL de imagen y devuelve el resultado procesado.

Mejora automática

POST/api/enhance

Mejora automáticamente la iluminación, el balance de color, la nitidez y el contraste. Úsalo como paso de limpieza por defecto en fotos de anuncios.

Ejemplos de mejora de imágenes
Fotos reales de anuncios antes y después del paso de mejora — habitaciones oscuras, color apagado, enfoque suave.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto a mejorar, o un data URI base64.
preserveOriginalFramingboolean
Mantén el aspect ratio y el encuadre originales exactos. Pon true cuando alimentes portales con especificaciones estrictas de imagen.
Default: false
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

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

Respuesta de ejemplo

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

Tiempo de respuesta: ~10 segundos por imagen. La respuesta puede incluir varias URLs cuando el modelo produce variantes.

Mejora + corrección de perspectiva

POST/api/enhance_and_correct_perspective

Igual que /api/enhance pero con un paso previo de corrección de perspectiva que endereza las líneas verticales. Úsalo cuando las fotos del anuncio se tomaron con el móvil inclinado hacia arriba o abajo.

Ejemplos de mejora de imágenes
Misma galería que /api/enhance — la corrección de perspectiva se nota más en exteriores tomados inclinados.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto, o un data URI base64.
preserveOriginalFramingboolean
Cuando es true, el pipeline preserva exactamente el encuadre, aspect ratio y resolución de entrada (sin recorte de bordes). Diseñado para verticales de verificación donde la salida debe representar legalmente la foto capturada.
Default: false
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Formato de respuesta: igual que /api/enhance (array). Tiempo de respuesta: ~15 segundos por imagen.

Sustitución de cielo

POST/api/sky_blue

Sustituye un cielo gris, cubierto o desvaído y mejora la iluminación. Por defecto un cielo azul limpio; usa skyStyle para elegir otra hora del día (amanecer, atardecer, noche).

Ejemplos de mejora de imágenes
Exteriores nublados convertidos en fotos de anuncios con cielo azul limpio.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto exterior, o un data URI base64.
skyStylestring
Qué cielo e iluminación aplicar. Por defecto "sunny". Opciones: "sunny" (cielo azul despejado y brillante), "sunny-no-reflections" (cielo azul con luz suave y uniforme — ideal para exteriores en sombra u orientados al norte), "sunrise" (mañana dorada y cálida), "dawn" (tonos de atardecer / anochecer), "night" (crepúsculo con luz cálida interior y de fachada).
Values: sunny sunny-no-reflections sunrise dawn night
Default: sunny
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

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

Respuesta de ejemplo

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

Tiempo de respuesta: ~10 segundos por imagen. Nota: aquí output es un objeto único, no un array.

Difuminar objetos

POST/api/blur

Difumina automáticamente contenido sensible como caras, matrículas o logos. Útil para fotos exteriores que tienen que cumplir con normas de portales.

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto original.
objectsToBlurstringobligatorio
Lista separada por comas de lo que se debe difuminar. Ejemplos: "faces", "license plates", "logos", "faces, license plates".
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

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

Respuesta de ejemplo

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

Tiempo de respuesta: ~10 segundos por imagen. output es un objeto único.

Siguiente

Mira Home staging virtual para editar muebles y contenido, o Crear vídeo para generar vídeos de anuncios a partir de fotos.