featureCode; Commet agrega los eventos para acceso, credits, balance y facturación.
Registrar un evento
Los eventos de modelos de IA usan la misma operación, pero envían
model, inputTokens y outputTokens en lugar de value.
ID del evento de negocio e idempotencia del request
eventId identifica el evento de consumo en tu sistema. Reutilízalo cuando reintentes el mismo evento.
La idempotencia del request protege una mutación HTTP y se pasa mediante las opciones del SDK como idempotencyKey. Se convierte en el header Idempotency-Key. No envíes esa clave de transporte dentro del body de uso.
Corregir el uso del período actual
Usaset cuando tu fuente de verdad necesite reemplazar el total medido actual:
value es el total deseado, no un delta. Commet registra un ajuste con signo y conserva el historial original de eventos. Esta operación aplica solamente al período medido activo.
Verificar antes de consumir
Cuando el acceso o costo dependan de la cantidad propuesta, llama a Usage Check antes de ejecutar la acción:Limitar el gasto de créditos del plan
Cuando un plan de créditos tiene un límite de créditos del plan, un evento que gastaría más créditos del plan de los que permite el día o la semana actual, y que los créditos comprados no cubren, se rechaza con402 plan_credit_limit_reached. No se descuenta nada.
Usage Check informa el mismo caso antes de consumir:
consumption.planCreditLimit. Muestra remaining y resetsAt al cliente, o deja que compre créditos, que el límite nunca limita.