QuotaMint

/v1/consume revisa el plan, el permiso de la función, el coste en créditos y el saldo, y responde con allowed: true o allowed: false. Un rechazo es una respuesta normal, no un error, así que tu aplicación puede enseñar una opción de mejora en lugar de una traza. La misma llamada escribe el apunte del libro cuando aprueba la petición.

/v1/check devuelve la misma forma de decisión sin reservar ni descontar créditos. Sirve para desactivar un botón, mostrar el saldo restante en los ajustes o avisar a un cliente antes de un trabajo largo. Como no escribe nada, puedes llamarla mientras la persona todavía está decidiendo.

Cada petición de consumo puede llevar una clave de idempotencia que identifica la operación de negocio, no el intento HTTP. Si una solicitud se agota y tu servidor reintenta con la misma clave, QuotaMint devuelve el resultado original y no cobra de más. Las peticiones simultáneas con la misma clave esperan a que termine la primera y reciben la respuesta guardada.

Defines planes como Starter con 500 créditos al mes y Pro con 2.000, y después fijas un coste por función: 1 crédito para texto, 10 para una imagen, 50 para un vídeo. Los permisos deciden a qué funciones llega cada plan. Un cambio de precio se aplica en la siguiente llamada y no hace falta desplegar nada.

Los consumos simultáneos no pueden dejar un saldo bajo cero. Si veinte llamadas compiten por diez créditos con un coste de diez, una pasa y las otras diecinueve vuelven rechazadas con insufficient_credits. Cada consumo aprobado deja una línea en el libro, y el historial muestra cuándo, dónde y qué función gastó los créditos, lo que cubre el seguimiento del uso de la API para soporte y finanzas.

Cada proyecto incluye claves de prueba y reales, que cuentan por separado dentro del límite del plan. Los datos de prueba nunca se mezclan con los saldos reales, así que un desarrollador puede ensayar una mejora, una bajada de plan o un saldo agotado contra la API verdadera antes de tocar producción.

/v1/events registra consumo medido que no lleva coste en créditos, como una llamada a la API, un documento procesado o un minuto de transcripción. Puedes medir tokens, imágenes, minutos o unidades propias y seguir leyendo un historial por cliente. Un producto sin créditos puede funcionar solo con permisos y eventos.

No hay biblioteca de cliente que instalar ni mantener. Cualquier lenguaje que envíe un POST por HTTPS sirve, incluidos TypeScript, Go, Python y Ruby, y el cuerpo de la petición se queda por debajo de 64 KiB por defecto. Tu servidor llama a QuotaMint directamente, así que el tráfico de la API nunca pasa por un proxy.