# Límites

## Límites de frecuencia

| Punto final | Límite | Cuando se supera |
|---|---|---|
| `POST /generate` | 300 solicitudes por minuto por clave API, 600 por minuto por cuenta | `429 RATE_LIMITED` con `Retry-After` |
| Modo de prueba (`mock=true`) | 30 solicitudes por minuto y 500 al día por cuenta | `429 RATE_LIMITED` con `Retry-After` |
| `GET /credits` | 60 solicitudes por minuto por clave de API | `429 RATE_LIMITED` |
| Llamadas a herramientas MCP | 60 por minuto por clave API | Resultado del error |
| `DELETE /results/:id`, `DELETE /customers/:id`, `DELETE /batches/:id` | 120 solicitudes por minuto por clave de API | `429 RATE_LIMITED` |
| `GET /results/:id`, `GET /generations/:id`, `GET /batches/:id` | 300 solicitudes por minuto por clave de API | `429 RATE_LIMITED` |
| `POST /generations`, `POST /batches` | Se contabiliza para el límite de 300 generadas por minuto | `429 RATE_LIMITED` |
| Tareas asíncronas que se ejecutan al mismo tiempo | 50 por cuenta (los lotes se cuentan por separado) | `429 TOO_MANY_JOBS` |

El límite de generación es una medida de seguridad frente a la fuga de claves y los bucles sin control. Las integraciones reales no llegan a alcanzarlo. En caso de que se prevea un volumen sostenido muy elevado, [ponte en contacto con nosotros](/contact) antes del lanzamiento para que podamos planificar la capacidad.

## Imágenes

| Límite | Valor |
|---|---|
| Formatos | JPEG, PNG, WebP, HEIC (se comprueba por el contenido, no por el nombre del archivo) |
| Tamaño máximo | 15 MB por imagen |
| `garment_url` | URL pública `https` en el puerto 443 u 80. Se bloquean las direcciones internas, privadas y de metadatos en la nube, incluso a través de redireccionamientos. |
| Resultado | Un archivo PNG por solicitud, de aproximadamente 1 megapíxel (la categoría «1K»), con el formato de la foto de la persona. Todavía no se ofrecen resoluciones más altas. |

## Hora

|  |  |
|---|---|
| Generación típica | Mediana de unos 19 segundos; el 90 % se sitúa en unos 24 segundos (tráfico de producción de los últimos 30 días) |
| Tiempo máximo de solicitud | 120 segundos. Configura el tiempo de espera del cliente en 120 segundos. |
| Prendas repetidas | El análisis de la prenda se almacena en caché durante 30 días, por lo que, si se vuelve a probar la misma foto de la prenda, se ahorran unos 2 segundos de preparación. |

## Créditos

|  |  |
|---|---|
| Comprar | Cualquier cantidad entre 50 y 100 000 por pedido |
| Caducidad | Nunca |
| Pruebas fallidas | Reembolso automático |
| Límite mensual por clave | Opcional, se configura al crear la clave. Abarca el mes natural en curso (UTC); una vez superado este plazo, la clave devuelve el código de error `402 KEY_LIMIT_REACHED` hasta el día 1. |
| Caducidad de la clave | Fecha opcional; la clave deja de funcionar a partir de ese día (UTC) |

## Tareas asíncronas y lotes

|  |  |
|---|---|
| Tamaño del lote | Hasta 500 elementos (10 en modo de prueba) |
| Resultados | Se conservan durante 7 días y, a continuación, se eliminan |
| Respuesta del webhook | Responde con `2xx` en un plazo de 8 segundos; las demás respuestas se volverán a intentar hasta un día después. |
| URL de webhooks | `https` público en el puerto estándar; no se siguen las redirecciones |
| Probar el webhook | Hasta 5 por minuto desde el panel de control |
