Guías
Registro de cambios de la API
Todas las modificaciones de la API para desarrolladores, ordenadas de más reciente a más antigua.
Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.
Cambios en la API para desarrolladores, ordenados de más reciente a más antiguo. Los formatos de solicitud y respuesta existentes no se modifican sin previo aviso en esta sección; se añaden nuevos campos y puntos finales junto a ellos.
19 de noviembre de 2026
- Novedad: Pruebas asíncronas:
POST /api/v1/generationsdevuelve una tarea de inmediato; se puede consultar enGET /api/v1/generations/:id. Documentación - Novedad: lotes de hasta 500 pruebas a partir de URL de imágenes:
POST /api/v1/batches,GETyDELETE /api/v1/batches/:id(los artículos cancelados se reembolsan). Documentación - Novedad: webhooks firmados
generation.completed,generation.failedybatch.completed, por solicitud (webhook_url) o como punto final de la cuenta con selección de eventos y un evento de prueba en Claves API > Webhooks. Documentación - Novedad:
GET /api/v1/results/:idpermite descargar un resultado guardado con tu clave. Los resultados asíncronos se conservan durante 7 días. - Novedad:
DELETE /api/v1/customers/:customer_idborra los resultados y registros almacenados de un usuario final. Se aceptacustomer_iden/generate,/generationsy elementos por lotes. Documentación - Novedad: límite de crédito mensual por clave y fecha de caducidad, que se establecen al crear una clave. Si se supera el límite:
402 KEY_LIMIT_REACHED. Documentación - Novedad: Modo de prueba (
?mock=true) para tareas asíncronas y lotes (hasta 10 elementos), gratuito. - Más rápido: el análisis de la prenda se almacena en caché durante 30 días, por lo que las pruebas repetidas de la misma foto del producto se aceleran unos 2 segundos.
- Panel de control: Búsqueda de generaciones por ID de cliente o ID de solicitud, filtro de periodo, vista en tiempo real y exportación a CSV. La vista general muestra la mediana y el percentil 95 del tiempo, así como la autonomía financiera.
- Seguridad: Los webhooks solo se envían a direcciones públicas que se comprueban en el momento de la conexión, sin seguir nunca las redirecciones.
18 de noviembre de 2026
- Novedad: encabezado
Idempotency-KeyenPOST /api/v1/generate; los reintentos nunca se cobran dos veces. Documentación - Novedad:
X-Request-Iden cada respuesta (yrequest_iden los cuerpos de los mensajes de error), además deX-RateLimit-LimityX-RateLimit-Remaining. - Novedad: especificación OpenAPI 3.1 en
https://www.tryoncloud.com/api/v1/openapi.json. - Novedad: Datos sobre el servicio público en
GET /api/v1/statusy en la página de estado. - Documentación: Resolución de salida indicada: aproximadamente 1 megapíxel (clase 1K).
14 de noviembre de 2026
- Novedad: el encabezado de webhook
x-tryoncloud-signature-v2, que firma la marca de tiempo junto con el cuerpo del mensaje para que se puedan rechazar las entregas antiguas.x-tryoncloud-signatureno ha sufrido cambios. Documentación - Modificado: Ahora se aplican límites de frecuencia en todos los servidores, con un límite para toda la cuenta de 600 solicitudes de generación por minuto y un límite independiente para el modo de prueba. Documentación
- Novedad:
GET /api/v1/credits, para comprobar las pruebas restantes con tu clave API. Documentación - Novedad: servidor MCP en
https://www.tryoncloud.com/api/mcppara Claude Code, Cursor y VS Code. Documentación - Novedad: JavaScript/TypeScript SDK. Documentación
- Novedad: Modo de prueba gratuito,
?mock=trueoX-Mock: true. Documentación - Novedad:
DELETE /api/v1/results/:id, para borrar antes de tiempo un resultado almacenado. Documentación - Modificación: El precio para empresas (más de 5.000 pruebas) se ha reducido de 0,08 $ a 0,07 $. En la India se mantiene en 6,50 ₹.
- Modificado: ahora se comprueban las descargas de
garment_urlen cada redirección y en el momento de establecer la conexión; se rechazan las direcciones internas, privadas y de metadatos en la nube. - Documentación: Nuevos documentos de varias páginas con versiones en Markdown de cada página, un acuerdo de tratamiento de datos y una autorización de reventa incluida en las condiciones de uso.
12 de noviembre de 2026
- Modificado: Nuevos precios para cada tramo: a partir de 50, 0,11 $; a partir de 300, 0,10 $; a partir de 1.000, 0,09 $; a partir de 5.000, 0,08 $.
- Novedad: claves API con nombre, hasta 5 activas, fechas de último uso, revocación una por una.
5 de noviembre de 2026
- Modificado:
POST /generatesiempre devuelveimage/png, tal y como indica suContent-Typedocumentado.