Cómo funcionan los límites de fotos y la regeneración en Tryon

Los Límites de Fotos permiten controlar quién puede generar fotos de prueba virtual y cuántas puede producir cada cliente en un período determinado. Funcionan junto con tus Créditos de Imagen (la cuota mensual de la tienda) para mantener el uso previsible y evitar abusos — especialmente en enlaces compartidos públicamente. Este artículo explica cada opción del panel Límites de Fotos y los mensajes de error que tu tienda puede devolver cuando una generación es bloqueada.

Dónde encontrar la configuración

Abre Configuración en la barra lateral del panel y busca el bloque Límites de Fotos en la columna izquierda de la página.

Período del Límite

Define la ventana usada para contar los límites por cliente. Actualmente fijo en Mensual: el contador de cada cliente se reinicia en la misma fecha de renovación de tus Créditos de Imagen.

Permitir regeneración

Controla qué pasa cuando un cliente intenta generar una foto para un producto que ya probó.

• Desactivado (por defecto) — Tryon devuelve la foto existente desde caché sin consumir ningún crédito. El cliente no puede regenerar la misma combinación producto/cliente.
• Activado — Tryon genera una foto nueva y consume un Crédito de Imagen. Útil cuando el cliente quiere reintentar con otra selfie o fondo.

Clientes Registrados

Clientes que han creado una cuenta en tu tienda. Cada cliente registrado tiene su propio contador individual.

• Interruptor apagado — Los clientes registrados no pueden generar fotos de prueba.
• Interruptor encendido + número de Límite de Fotos — Cada cliente registrado puede generar hasta N fotos por período (por ejemplo, 10 al mes).
• Interruptor encendido + Ilimitado — Cada cliente registrado puede generar tantas fotos como permitan los Créditos de Imagen de la tienda.

Clientes Invitados

Visitantes anónimos que no han creado cuenta. Su contador es compartido entre todos los invitados de tu tienda — no es individual.

• Interruptor apagado — Los invitados no pueden generar fotos. Tienen que registrarse / iniciar sesión (o el enlace ni siquiera funciona si el acceso de registrados también está desactivado).
• Interruptor encendido + número de Límite de Fotos — Todos los invitados combinados pueden generar hasta N fotos por período (por ejemplo, 200 al mes).
• Interruptor encendido + Ilimitado — Los invitados pueden seguir generando hasta que se agoten los Créditos de Imagen de la tienda.

Cómo se verifica una solicitud de generación

Cada solicitud de prueba pasa por estas comprobaciones, en orden. Fallar cualquiera de ellas bloquea la generación y devuelve un código de error:

1. Créditos de Imagen de la tienda — debe quedar al menos un crédito del mes.
2. Tipo de cliente habilitado — el tipo del cliente que solicita (invitado o registrado) debe estar activado.
3. Límite por cliente / compartido — el contador correspondiente debe estar por debajo de su límite configurado.
4. Política de regeneración — si existe un resultado en caché, la respuesta depende del ajuste Permitir regeneración.

Mensajes de error devueltos cuando una generación es bloqueada

La tabla siguiente lista todos los códigos de error que la API de prueba virtual puede devolver por razones ligadas a los Límites de Fotos. La primera columna es el código en bruto que recibe tu widget; la segunda explica qué lo disparó y cómo recuperarse.

Código de error	Qué significa / qué hacer
subscription_credits_not_found	La plataforma no pudo cargar la cuota mensual de créditos de tu suscripción. Suele ser transitorio — vuelve a intentarlo en unos instantes. Si persiste, contacta al soporte.
subscription_images_limit_reached	Tu tienda ha usado todos los Créditos de Imagen del mes. Las nuevas generaciones quedan bloqueadas hasta la renovación o hasta que actualices tu plan / añadas créditos.
customer_credits_not_available	Ningún tipo de cliente está habilitado para este perfil de visitante. Abre E-commerce → Paso 4 (Photo limits) y activa Clientes Registrados, Clientes Invitados o ambos.
guest_require_login	Un visitante anónimo intentó generar una foto, pero Clientes Invitados está desactivado y Clientes Registrados está activado. El widget debe pedir al visitante que inicie sesión o cree una cuenta.
guest_limit_reached	La cuota compartida de invitados para el período fue consumida. Los invitados estarán bloqueados hasta el reinicio del contador o hasta que aumentes el límite / pases a Ilimitado.
customer_limit_reached	Este cliente registrado específico alcanzó su límite personal de fotos del período. Puede volver tras el reinicio o puedes aumentar el límite por cliente.
regenerate_blocked	El cliente ya generó una foto para este producto y Permitir regeneración está desactivado. La imagen en caché no se devuelve a propósito. Activa Permitir regeneración si quieres dejar que los clientes reintenten.
already_generated	No es exactamente un error — Tryon reconoció la solicitud como repetida y devolvió la foto generada anteriormente (porque Permitir regeneración está activado o se acertó en la caché). No se consume ningún crédito nuevo.

Configuración inicial recomendada

• Permitir regeneración: Desactivado — protege tus Créditos de Imagen para que no se consuman en reintentos.
• Clientes Registrados: Activado, Límite de Fotos entre 5 y 10 por mes. Lo bastante generoso para que los compradores reales no choquen contra el tope.
• Clientes Invitados: Desactivado si tu tienda requiere cuenta. Si quieres Magic Links públicos, actívalo con un tope compartido conservador (por ejemplo, 100–500) y vigila el panel ante picos de tráfico.