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.
highFidelityboolean
Mejora no generativa: ajusta solo la luz y la nitidez, y mantiene los colores, los materiales, el tamaño de los objetos y el encuadre exactamente como en la foto original. Ideal cuando el resultado debe ser fiel al original. Cuando es true, se ignora preserveOriginalFraming.
Default: false
preserveOriginalFramingboolean
Mantén el encuadre, el aspect ratio y la resolución originales exactos (sin recorte de bordes). La mejora sigue siendo generada por IA, por lo que los colores y materiales pueden variar ligeramente — si deben permanecer idénticos, usa highFidelity. Se ignora cuando highFidelity es true.
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",
    "highFidelity": 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.
highFidelityboolean
Mejora no generativa con corrección de perspectiva: ajusta solo la luz, la nitidez y la perspectiva, y mantiene los colores, los materiales y el tamaño de los objetos exactamente como en el original. Cuando es true, se ignora preserveOriginalFraming.
Default: false
preserveOriginalFramingboolean
Preserva exactamente el encuadre, el aspect ratio y la resolución de entrada (sin recorte de bordes) al corregir la perspectiva. La mejora sigue siendo generada por IA, por lo que los colores y materiales pueden variar ligeramente — usa highFidelity si deben permanecer idénticos. Se ignora cuando highFidelity es true.
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.