Contrato de solicitud
Envía POST /api/v1/decisions con Authorization: Bearer YOUR_API_KEY, Content-Type: application/json e Idempotency-Key. El cuerpo incluye text (3–6.000 caracteres), instructions (3–1.500), labels (2–12 opciones únicas de hasta 60 caracteres) y threshold (0,5–1).
Cada solicitud completada consume un crédito. Las pruebas anónimas tienen un límite separado.
Contrato de respuesta
Lee choice, confidence, probabilities, needsReview, model, id y latencyMs. Si el proveedor omite confianza, confidence será null y needsReview será true. Un fallo devuelve un error, nunca una etiqueta inventada.
Reintentos seguros
Utiliza una clave por solicitud lógica y repítela si desconoces el resultado de la conexión. Una solicitud completada devuelve el resultado guardado sin otro cargo. Una clave con entradas distintas devuelve 409. Tras un fallo, resuelve la causa y usa una nueva clave.