Flat Lay API

La API de Flat Lay de Photoroom convierte automáticamente la foto de una prenda en una imagen de producto con estilo flat lay, limpia y vista desde arriba, lista para el comercio electrónico y los marketplaces. Es una de las más de 20 ediciones disponibles en la API de Photoroom.

Sí. Con la API de Photoroom, envías una foto de una prenda con flatLay.mode configurado en ai.auto y recibes una imagen con el estilo Flat Lay por llamada. Puedes ejecutar varias llamadas en paralelo hasta alcanzar el límite de solicitudes, que es de 60 imágenes por minuto de forma predeterminada. Así, puedes conectarla a tu catálogo o flujo de carga y colocar automáticamente cada prenda nueva en plano.

Con la API de Photoroom, envías una foto de una prenda y recibes una imagen Flat Lay limpia, tomada desde arriba y lista para el comercio electrónico y los marketplaces, sin tener que preparar, acomodar y fotografiar la prenda a mano. Las llamadas se ejecutan en paralelo y procesan 60 imágenes por minuto de forma predeterminada, así que puedes procesar todo un catálogo con esa misma llamada.

Para los catálogos de ropa, la API Flat Lay de Photoroom está diseñada para procesar grandes volúmenes. Con una sola integración, puedes presentar cada foto de ropa en plano y acceder a más de 20 ediciones adicionales, como la eliminación del fondo, Maniquí fantasma y Planchado con IA. Los planes Enterprise ofrecen límites de solicitudes más altos y controles de resultados para catálogos grandes: habla con el equipo de ventas.

Flat Lay coloca la prenda en horizontal y la muestra desde arriba. Maniquí fantasma muestra la ropa sin maniquí y capta cómo queda y cómo cae. Modelo virtual convierte fotos de ropa en imágenes de estilo de vida con modelos de IA predefinidos o personalizados. Las tres opciones funcionan con la misma API de Photoroom, así que una sola integración sirve para las tres.

Obtén tu clave de API y luego envía la foto de tu prenda con flatLay.mode configurado como ai.auto:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form flatLay.mode=ai.auto \
  --output result.png

Todos los parámetros están en la documentación de Flat Lay.

Envía cada foto de prenda con la misma llamada a la API de Photoroom y la misma configuración. Estos son los ajustes que puedes cambiar:

• flatLay.mode: configúralo en ai.auto para usar Flat Lay.

• flatLay.size: el tamaño de salida y la relación de aspecto de la imagen generada. El valor predeterminado es SQUARE_HD. Los demás valores son PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 y LANDSCAPE_HD_16_9.

• flatLay.prompt: un Prompt opcional para orientar el estilo de generación, por ejemplo, una composición cenital limpia de estudio.

Envía archivos PNG, JPEG, WEBP o AVIF de hasta 30 MB y 5,000 píxeles en el lado más ancho, y recibe imágenes en esos mismos formatos. Flat Lay devuelve imágenes en 1K (1024 x 1024) de forma predeterminada. La salida en 2K y 4K está disponible en los planes Enterprise. Encontrarás más detalles en la documentación sobre tamaño, resolución y formato de archivo.

Flat Lay está incluido en el plan Plus API, por $100 al mes ($0.10 por imagen), y en los planes Enterprise: habla con ventas. Cada llamada cuesta $0.10 y puede incluir tantas opciones de edición como necesites sin que esto afecte el precio. Las llamadas que devuelven un error no consumen una imagen. Primero puedes probar la API de edición de imágenes en modo sandbox, con 1,000 llamadas gratuitas al mes con marca de agua. Encontrarás más detalles en la página de precios.

Sí. Photoroom tiene un servidor MCP para asistentes de IA como Claude que incluye Flat Lay. Consulta Photoroom MCP para obtener más información.

¿Tienes problemas con la API? Únete a nuestra comunidad de la API para recibir ayuda de nuestros ingenieros o consulta la página de solución de problemas para ver los problemas más comunes.

Si se trata de facturación o de información confidencial, envíale un mensaje directo a Photoroom en la comunidad. Siempre estaremos encantados de ayudarte.