Saltar al contenido principal
Cada feature medida tiene un único código. Envía ese código como featureCode; Commet agrega los eventos para acceso, credits, balance y facturación.

Registrar un evento

El request acepta: 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

Usa set 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 con 402 plan_credit_limit_reached. No se descuenta nada. Usage Check informa el mismo caso antes de consumir:
Solo los créditos del plan cuentan para el límite. Los eventos aceptados devuelven el límite actualizado en consumption.planCreditLimit. Muestra remaining y resetsAt al cliente, o deja que compre créditos, que el límite nunca limita.