StageinHome API

StageinHome API es un componente que permite a los usuarios de Nappai transformar cualquier foto de una habitación en una imagen decorada automáticamente. Solo necesitas subir la foto (en base64 o como enlace), elegir el estilo y el tipo de habitación, y el componente se encarga de enviar la imagen a la API de StageInHome, esperar a que el proceso termine y devolver la imagen decorada.

¿Cómo funciona?

1. Entrada de la imagen
   El componente acepta la imagen en formato base64 o un enlace HTTP. Si la imagen es un enlace, el componente la descarga antes de enviarla a la API.

2. Conexión con StageInHome
   Se hace una llamada a la API de StageInHome (https://api.stageinhome.com).

   • Primero se verifica que la API esté disponible con un ping.
   • Luego se sube la imagen junto con los parámetros de room_type (tipo de habitación) y style (estilo de decoración).
   • La API devuelve un identificador (img_id) que se usa para consultar el estado del trabajo.

3. Espera y obtención del resultado
   El componente consulta periódicamente la API hasta que el estado sea STATUS = 1, indicando que la decoración está lista.
   Cuando está lista, se recibe la imagen decorada en base64.

4. Salida
   La imagen decorada se devuelve como un objeto Data con un texto Markdown que muestra la imagen (![Result](data:image/png;base64,...)).
   Este texto puede ser usado directamente en cualquier componente que acepte Markdown o en un visor de imágenes.

Entradas

Credencial requerida
Este componente necesita una credencial de tipo StageInHome AI system.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada StageInHome AI system.
2. Ingresa tu StageinHome API Key (la contraseña).
3. En el componente, selecciona esa credencial en el campo Credential.

Campos de Entrada

• Image in base 64: Imagen de entrada en formato base64 o un enlace HTTP.
• Room Choice: Tipo de habitación a decorar (bedroom, living_room, bathroom, kitchen).
• Style Choice: Estilo de decoración (modern, rustic, industrial, scandinavian).

Salidas

• Output: Un objeto Data que contiene la imagen decorada en formato Markdown.
  Puedes usarlo en un visor de imágenes, guardarlo en un archivo o enviarlo a otro componente.

Ejemplo de Uso

1. Sube una foto
   • En el panel de entrada, pega la imagen en base64 o escribe la URL de la foto.
2. Selecciona la habitación
   • Elige bedroom en Room Choice.
3. Elige el estilo
   • Selecciona modern en Style Choice.
4. Ejecuta el flujo
   • Haz clic en Run y espera a que el componente termine.
5. Visualiza el resultado
   • El componente mostrará la imagen decorada en la salida. Puedes copiar el Markdown y pegarlo en cualquier lugar que soporte imágenes en base64.

Componentes Relacionados

• ImageUploader – Para cargar imágenes desde tu dispositivo.
• ImageViewer – Para mostrar imágenes en el dashboard.
• MarkdownRenderer – Para renderizar el texto Markdown que devuelve StageInHome API.

Consejos y Mejores Prácticas

• Usa imágenes de alta resolución para obtener mejores resultados de decoración.
• Evita subir imágenes con derechos de autor sin permiso.
• Si trabajas con muchas imágenes, considera usar la API en modo batch (si está disponible) para reducir el tiempo de espera.
• Guarda la salida en un formato que puedas reutilizar (por ejemplo, como archivo PNG) para evitar decodificar base64 cada vez.

Consideraciones de Seguridad

• La API Key de StageInHome debe mantenerse secreta; no la compartas en el código ni la publiques.
• Nappai ya cifra las credenciales, pero siempre revisa que la conexión a la API sea HTTPS.
• Si la API devuelve errores, revisa los logs para detectar posibles problemas de autenticación o límites de uso.