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.
Default: false
preserveAspectRatioboolean
Por defecto, el resultado se devuelve con el tamaño que genere el modelo de IA, que puede no coincidir con el aspect ratio ni la resolución de tu foto. Ponlo en true para recibir el resultado con el ancho y el alto exactos de la imagen de entrada: se recorta desde el centro al aspect ratio original (nunca se estira) y se redimensiona a la resolución original.
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. La respuesta incluye además <code>source</code> (<code>imageId</code> y <code>name</code>) de la foto original, si ya está en esa propiedad o si envías también <code>name</code>.
namestring
Nombre opcional para la foto original (p. ej. su nombre de archivo), hasta 200 caracteres. Requiere <code>propertyId</code>. Si la foto aún no está en esa propiedad, se guarda allí con este nombre en la misma llamada, así que no hace falta llamar antes a <code>add_images_to_property</code>, y se devuelve como <code>source.name</code>. Una foto que ya está en la propiedad mantiene su nombre. Nunca aparece en la imagen.

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.
Default: false
preserveAspectRatioboolean
Por defecto, el resultado se devuelve con el tamaño que genere el modelo de IA, que puede no coincidir con el aspect ratio ni la resolución de tu foto. Ponlo en true para recibir el resultado con el ancho y el alto exactos de la imagen de entrada: se recorta desde el centro al aspect ratio original (nunca se estira) y se redimensiona a la resolución original.
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. La respuesta incluye además <code>source</code> (<code>imageId</code> y <code>name</code>) de la foto original, si ya está en esa propiedad o si envías también <code>name</code>.
namestring
Nombre opcional para la foto original (p. ej. su nombre de archivo), hasta 200 caracteres. Requiere <code>propertyId</code>. Si la foto aún no está en esa propiedad, se guarda allí con este nombre en la misma llamada, así que no hace falta llamar antes a <code>add_images_to_property</code>, y se devuelve como <code>source.name</code>. Una foto que ya está en la propiedad mantiene su nombre. Nunca aparece en la imagen.

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
preserveAspectRatioboolean
Por defecto, el resultado se devuelve con el tamaño que genere el modelo de IA, que puede no coincidir con el aspect ratio ni la resolución de tu foto. Ponlo en true para recibir el resultado con el ancho y el alto exactos de la imagen de entrada: se recorta desde el centro al aspect ratio original (nunca se estira) y se redimensiona a la resolución original.
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. La respuesta incluye además <code>source</code> (<code>imageId</code> y <code>name</code>) de la foto original, si ya está en esa propiedad o si envías también <code>name</code>.
namestring
Nombre opcional para la foto original (p. ej. su nombre de archivo), hasta 200 caracteres. Requiere <code>propertyId</code>. Si la foto aún no está en esa propiedad, se guarda allí con este nombre en la misma llamada, así que no hace falta llamar antes a <code>add_images_to_property</code>, y se devuelve como <code>source.name</code>. Una foto que ya está en la propiedad mantiene su nombre. Nunca aparece en la imagen.

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".
preserveAspectRatioboolean
Por defecto, el resultado se devuelve con el tamaño que genere el modelo de IA, que puede no coincidir con el aspect ratio ni la resolución de tu foto. Ponlo en true para recibir el resultado con el ancho y el alto exactos de la imagen de entrada: se recorta desde el centro al aspect ratio original (nunca se estira) y se redimensiona a la resolución original.
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. La respuesta incluye además <code>source</code> (<code>imageId</code> y <code>name</code>) de la foto original, si ya está en esa propiedad o si envías también <code>name</code>.
namestring
Nombre opcional para la foto original (p. ej. su nombre de archivo), hasta 200 caracteres. Requiere <code>propertyId</code>. Si la foto aún no está en esa propiedad, se guarda allí con este nombre en la misma llamada, así que no hace falta llamar antes a <code>add_images_to_property</code>, y se devuelve como <code>source.name</code>. Una foto que ya está en la propiedad mantiene su nombre. Nunca aparece en la imagen.

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.