Referencia de la API
Límites
Límites de frecuencia, límites de imágenes, tiempos de espera y velocidad.
Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.
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 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 |