Search docs

Search the TryOnCloud API docs

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 finalLímiteCuando se supera
POST /generate300 solicitudes por minuto por clave API, 600 por minuto por cuenta429 RATE_LIMITED con Retry-After
Modo de prueba (mock=true)30 solicitudes por minuto y 500 al día por cuenta429 RATE_LIMITED con Retry-After
GET /credits60 solicitudes por minuto por clave de API429 RATE_LIMITED
Llamadas a herramientas MCP60 por minuto por clave APIResultado del error
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 solicitudes por minuto por clave de API429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 solicitudes por minuto por clave de API429 RATE_LIMITED
POST /generations, POST /batchesSe contabiliza para el límite de 300 generadas por minuto429 RATE_LIMITED
Tareas asíncronas que se ejecutan al mismo tiempo50 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ímiteValor
FormatosJPEG, PNG, WebP, HEIC (se comprueba por el contenido, no por el nombre del archivo)
Tamaño máximo15 MB por imagen
garment_urlURL 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.
ResultadoUn 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ípicaMediana 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 solicitud120 segundos. Configura el tiempo de espera del cliente en 120 segundos.
Prendas repetidasEl 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

ComprarCualquier cantidad entre 50 y 100 000 por pedido
CaducidadNunca
Pruebas fallidasReembolso automático
Límite mensual por claveOpcional, 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 claveFecha opcional; la clave deja de funcionar a partir de ese día (UTC)

Tareas asíncronas y lotes

Tamaño del loteHasta 500 elementos (10 en modo de prueba)
ResultadosSe conservan durante 7 días y, a continuación, se eliminan
Respuesta del webhookResponde 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 webhookshttps público en el puerto estándar; no se siguen las redirecciones
Probar el webhookHasta 5 por minuto desde el panel de control