Instalar el widget en otra tienda

Tres pasos, sin tocar el código del widget: registrar la tienda en el servidor, poner la foto y pegar una línea en la ficha de producto.

1. Registra la tienda en el servidor

Crea tiendas/<id-tienda>.json junto a los demos (el servidor lo lee al instante, sin reiniciar). El id solo admite minúsculas, dígitos y guiones.

{
  "nombre": "Velas del Bosque",
  "pregunta": "¿En qué rincón de tu casa encenderías esta vela?",
  "placeholder": "Ej.: en la mesita de noche, junto a la bañera, en la terraza…",
  "boton": "Ver mi rincón",
  "escena": "Around the candle, this place comes to life: \"{respuesta}\". The candle flame flickers softly; the room is cozy and calm.",
  "productos": {
    "lavanda": {
      "nombre": "Vela de lavanda 200 g",
      "descripcion": "lit lavender-colored soy candle in a glass jar",
      "imagen": "velas-lavanda.jpg"
    }
  }
}

• escena es la única parte del prompt que escribe la tienda. Debe contener {respuesta} entre comillas: es el hueco donde va el texto del visitante. El servidor añade delante la orden de cámara fija y producto intacto, y detrás el cierre fotorrealista.
• descripcion describe el producto en inglés (el modelo lo entiende mejor) y se usa para decirle al modelo qué es lo que no debe cambiar.
• Opcional: "precalentar": ["respuesta 1", "respuesta 2"] para generar de antemano las respuestas más probables con npm run precalentar.

2. Pon la foto del producto

Copia la foto a productos/ con el nombre indicado en imagen (JPG, PNG o WebP; recomendable 16:9, producto centrado y fondo limpio: el video conserva el encuadre de la foto). La foto se sube una sola vez al almacenamiento de fal y se reutiliza.

3. Pega una línea en la ficha de producto

<script src="https://TU-SERVIDOR/widget.js" data-tienda="velas" data-producto="lavanda"></script>

El widget se dibuja justo después de la etiqueta <script>. Si prefieres colocarlo en otro sitio, añade data-contenedor="#mi-div". Funciona desde cualquier dominio (CORS abierto) y aísla sus estilos con Shadow DOM, así que no rompe el CSS de la tienda.

Comprobar

• https://TU-SERVIDOR/api/config?tienda=velas&producto=lavanda debe devolver la pregunta y la foto.
• El primer visitante que escriba una respuesta generará el video; el segundo con la misma respuesta lo recibirá desde caché. Míralo en Métricas.

Límites y respaldo

Cada IP puede generar 3 videos nuevos al día y el servidor 40 en total (LIMITE_IP_DIA, LIMITE_TOTAL en .env). Al superarlos el widget no falla: muestra un video ya generado del mismo producto y avisa. Si aún no existe ninguno, muestra la foto.