feat: implement tiered billing expression evaluation and related functionality
- Added support for tiered billing expressions in the billing system. - Introduced new types and functions for handling billing expressions, including caching and execution. - Updated existing billing logic to accommodate tiered billing scenarios. - Enhanced request handling to support incoming billing expression requests. - Added tests for tiered billing functionality to ensure correctness.
This commit is contained in:
@@ -0,0 +1,401 @@
|
||||
package service
|
||||
|
||||
import (
|
||||
"testing"
|
||||
|
||||
"github.com/QuantumNous/new-api/pkg/billingexpr"
|
||||
relaycommon "github.com/QuantumNous/new-api/relay/common"
|
||||
)
|
||||
|
||||
// Claude Sonnet-style tiered expression: standard vs long-context
|
||||
const sonnetTieredExpr = `p <= 200000 ? tier("standard", p * 1.5 + c * 7.5) : tier("long_context", p * 3 + c * 11.25)`
|
||||
|
||||
// Simple flat expression
|
||||
const flatExpr = `tier("default", p * 2 + c * 10)`
|
||||
|
||||
// Expression with cache tokens
|
||||
const cacheExpr = `tier("default", p * 2 + c * 10 + cr * 0.2 + cc * 2.5 + cc1h * 4)`
|
||||
|
||||
// Expression with request probes
|
||||
const probeExpr = `param("service_tier") == "fast" ? tier("fast", p * 4 + c * 20) : tier("normal", p * 2 + c * 10)`
|
||||
|
||||
func makeSnapshot(expr string, groupRatio float64, estPrompt, estCompletion int) *billingexpr.BillingSnapshot {
|
||||
return &billingexpr.BillingSnapshot{
|
||||
BillingMode: "tiered_expr",
|
||||
ExprString: expr,
|
||||
ExprHash: billingexpr.ExprHashString(expr),
|
||||
GroupRatio: groupRatio,
|
||||
EstimatedPromptTokens: estPrompt,
|
||||
EstimatedCompletionTokens: estCompletion,
|
||||
}
|
||||
}
|
||||
|
||||
func makeRelayInfo(expr string, groupRatio float64, estPrompt, estCompletion int) *relaycommon.RelayInfo {
|
||||
snap := makeSnapshot(expr, groupRatio, estPrompt, estCompletion)
|
||||
cost, trace, _ := billingexpr.RunExpr(expr, billingexpr.TokenParams{P: float64(estPrompt), C: float64(estCompletion)})
|
||||
snap.EstimatedQuotaBeforeGroup = cost
|
||||
snap.EstimatedQuotaAfterGroup = billingexpr.QuotaRound(cost * groupRatio)
|
||||
snap.EstimatedTier = trace.MatchedTier
|
||||
return &relaycommon.RelayInfo{
|
||||
TieredBillingSnapshot: snap,
|
||||
FinalPreConsumedQuota: snap.EstimatedQuotaAfterGroup,
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Existing tests (preserved)
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettleUsesFrozenRequestInput(t *testing.T) {
|
||||
exprStr := `param("service_tier") == "fast" ? tier("fast", p * 2) : tier("normal", p)`
|
||||
relayInfo := &relaycommon.RelayInfo{
|
||||
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
|
||||
BillingMode: "tiered_expr",
|
||||
ExprString: exprStr,
|
||||
ExprHash: billingexpr.ExprHashString(exprStr),
|
||||
GroupRatio: 1.0,
|
||||
EstimatedPromptTokens: 100,
|
||||
EstimatedCompletionTokens: 0,
|
||||
EstimatedQuotaAfterGroup: 100,
|
||||
},
|
||||
BillingRequestInput: &billingexpr.RequestInput{
|
||||
Body: []byte(`{"service_tier":"fast"}`),
|
||||
},
|
||||
}
|
||||
|
||||
ok, quota, result := TryTieredSettle(relayInfo, billingexpr.TokenParams{P: 100})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle to apply")
|
||||
}
|
||||
if quota != 200 {
|
||||
t.Fatalf("quota = %d, want 200", quota)
|
||||
}
|
||||
if result == nil || result.MatchedTier != "fast" {
|
||||
t.Fatalf("matched tier = %v, want fast", result)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettleFallsBackToFrozenPreConsumeOnExprError(t *testing.T) {
|
||||
relayInfo := &relaycommon.RelayInfo{
|
||||
FinalPreConsumedQuota: 321,
|
||||
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
|
||||
BillingMode: "tiered_expr",
|
||||
ExprString: `invalid +-+ expr`,
|
||||
ExprHash: billingexpr.ExprHashString(`invalid +-+ expr`),
|
||||
GroupRatio: 1.0,
|
||||
EstimatedQuotaAfterGroup: 123,
|
||||
},
|
||||
}
|
||||
|
||||
ok, quota, result := TryTieredSettle(relayInfo, billingexpr.TokenParams{P: 100})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle to apply")
|
||||
}
|
||||
if quota != 321 {
|
||||
t.Fatalf("quota = %d, want 321", quota)
|
||||
}
|
||||
if result != nil {
|
||||
t.Fatalf("result = %#v, want nil", result)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Pre-consume vs Post-consume consistency
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_PreConsumeMatchesPostConsume(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.0, 1000, 500)
|
||||
params := billingexpr.TokenParams{P: 1000, C: 500}
|
||||
|
||||
ok, quota, _ := TryTieredSettle(info, params)
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// p*2 + c*10 = 2000 + 5000 = 7000
|
||||
if quota != 7000 {
|
||||
t.Fatalf("quota = %d, want 7000", quota)
|
||||
}
|
||||
if quota != info.FinalPreConsumedQuota {
|
||||
t.Fatalf("pre-consume %d != post-consume %d", info.FinalPreConsumedQuota, quota)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_PostConsumeOverPreConsume(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.0, 1000, 500)
|
||||
preConsumed := info.FinalPreConsumedQuota // 7000
|
||||
|
||||
// Actual usage is higher than estimated
|
||||
params := billingexpr.TokenParams{P: 2000, C: 1000}
|
||||
ok, quota, _ := TryTieredSettle(info, params)
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// p*2 + c*10 = 4000 + 10000 = 14000
|
||||
if quota != 14000 {
|
||||
t.Fatalf("quota = %d, want 14000", quota)
|
||||
}
|
||||
if quota <= preConsumed {
|
||||
t.Fatalf("expected supplement: actual %d should > pre-consumed %d", quota, preConsumed)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_PostConsumeUnderPreConsume(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.0, 1000, 500)
|
||||
preConsumed := info.FinalPreConsumedQuota // 7000
|
||||
|
||||
// Actual usage is lower than estimated
|
||||
params := billingexpr.TokenParams{P: 100, C: 50}
|
||||
ok, quota, _ := TryTieredSettle(info, params)
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// p*2 + c*10 = 200 + 500 = 700
|
||||
if quota != 700 {
|
||||
t.Fatalf("quota = %d, want 700", quota)
|
||||
}
|
||||
if quota >= preConsumed {
|
||||
t.Fatalf("expected refund: actual %d should < pre-consumed %d", quota, preConsumed)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Tiered boundary conditions
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_ExactBoundary(t *testing.T) {
|
||||
info := makeRelayInfo(sonnetTieredExpr, 1.0, 200000, 1000)
|
||||
|
||||
// p == 200000 => standard tier (p <= 200000)
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 200000, C: 1000})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// standard: p*1.5 + c*7.5 = 300000 + 7500 = 307500
|
||||
if quota != 307500 {
|
||||
t.Fatalf("quota = %d, want 307500", quota)
|
||||
}
|
||||
if result.MatchedTier != "standard" {
|
||||
t.Fatalf("tier = %s, want standard", result.MatchedTier)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_BoundaryPlusOne(t *testing.T) {
|
||||
info := makeRelayInfo(sonnetTieredExpr, 1.0, 200000, 1000)
|
||||
|
||||
// p == 200001 => crosses to long_context tier
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 200001, C: 1000})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// long_context: p*3 + c*11.25 = 600003 + 11250 = 611253
|
||||
if quota != 611253 {
|
||||
t.Fatalf("quota = %d, want 611253", quota)
|
||||
}
|
||||
if result.MatchedTier != "long_context" {
|
||||
t.Fatalf("tier = %s, want long_context", result.MatchedTier)
|
||||
}
|
||||
if !result.CrossedTier {
|
||||
t.Fatal("expected CrossedTier = true")
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_ZeroTokens(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.0, 0, 0)
|
||||
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 0, C: 0})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
if quota != 0 {
|
||||
t.Fatalf("quota = %d, want 0", quota)
|
||||
}
|
||||
if result == nil {
|
||||
t.Fatal("result should not be nil")
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_HugeTokens(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.0, 10000000, 5000000)
|
||||
|
||||
ok, quota, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 10000000, C: 5000000})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// p*2 + c*10 = 20000000 + 50000000 = 70000000
|
||||
if quota != 70000000 {
|
||||
t.Fatalf("quota = %d, want 70000000", quota)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_CacheTokensAffectSettlement(t *testing.T) {
|
||||
info := makeRelayInfo(cacheExpr, 1.0, 1000, 500)
|
||||
|
||||
// Without cache tokens
|
||||
ok1, quota1, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if !ok1 {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// p*2 + c*10 + cr*0.2 + cc*2.5 + cc1h*4 = 2000 + 5000 + 0 + 0 + 0 = 7000
|
||||
|
||||
// With cache tokens
|
||||
ok2, quota2, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500, CR: 10000, CC: 5000, CC1h: 2000})
|
||||
if !ok2 {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// 2000 + 5000 + 10000*0.2 + 5000*2.5 + 2000*4 = 2000 + 5000 + 2000 + 12500 + 8000 = 29500
|
||||
|
||||
if quota2 <= quota1 {
|
||||
t.Fatalf("cache tokens should increase quota: without=%d, with=%d", quota1, quota2)
|
||||
}
|
||||
if quota1 != 7000 {
|
||||
t.Fatalf("no-cache quota = %d, want 7000", quota1)
|
||||
}
|
||||
if quota2 != 29500 {
|
||||
t.Fatalf("cache quota = %d, want 29500", quota2)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Request probe tests
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_RequestProbeInfluencesBilling(t *testing.T) {
|
||||
info := makeRelayInfo(probeExpr, 1.0, 1000, 500)
|
||||
info.BillingRequestInput = &billingexpr.RequestInput{
|
||||
Body: []byte(`{"service_tier":"fast"}`),
|
||||
}
|
||||
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// fast: p*4 + c*20 = 4000 + 10000 = 14000
|
||||
if quota != 14000 {
|
||||
t.Fatalf("quota = %d, want 14000", quota)
|
||||
}
|
||||
if result.MatchedTier != "fast" {
|
||||
t.Fatalf("tier = %s, want fast", result.MatchedTier)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_NoRequestInput_FallsBackToDefault(t *testing.T) {
|
||||
info := makeRelayInfo(probeExpr, 1.0, 1000, 500)
|
||||
// No BillingRequestInput set — param("service_tier") returns nil, not "fast"
|
||||
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// normal: p*2 + c*10 = 2000 + 5000 = 7000
|
||||
if quota != 7000 {
|
||||
t.Fatalf("quota = %d, want 7000", quota)
|
||||
}
|
||||
if result.MatchedTier != "normal" {
|
||||
t.Fatalf("tier = %s, want normal", result.MatchedTier)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Group ratio tests
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_GroupRatioScaling(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 1.5, 1000, 500)
|
||||
|
||||
ok, quota, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
// cost = 7000, after group = round(7000 * 1.5) = 10500
|
||||
if quota != 10500 {
|
||||
t.Fatalf("quota = %d, want 10500", quota)
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_GroupRatioZero(t *testing.T) {
|
||||
info := makeRelayInfo(flatExpr, 0, 1000, 500)
|
||||
|
||||
ok, quota, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle")
|
||||
}
|
||||
if quota != 0 {
|
||||
t.Fatalf("quota = %d, want 0 (group ratio = 0)", quota)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Ratio mode (negative tests) — TryTieredSettle must return false
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_RatioMode_NilSnapshot(t *testing.T) {
|
||||
info := &relaycommon.RelayInfo{
|
||||
TieredBillingSnapshot: nil,
|
||||
}
|
||||
|
||||
ok, _, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if ok {
|
||||
t.Fatal("expected TryTieredSettle to return false when snapshot is nil")
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_RatioMode_WrongBillingMode(t *testing.T) {
|
||||
info := &relaycommon.RelayInfo{
|
||||
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
|
||||
BillingMode: "ratio",
|
||||
ExprString: flatExpr,
|
||||
ExprHash: billingexpr.ExprHashString(flatExpr),
|
||||
GroupRatio: 1.0,
|
||||
},
|
||||
}
|
||||
|
||||
ok, _, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if ok {
|
||||
t.Fatal("expected TryTieredSettle to return false for ratio billing mode")
|
||||
}
|
||||
}
|
||||
|
||||
func TestTryTieredSettle_RatioMode_EmptyBillingMode(t *testing.T) {
|
||||
info := &relaycommon.RelayInfo{
|
||||
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
|
||||
BillingMode: "",
|
||||
ExprString: flatExpr,
|
||||
ExprHash: billingexpr.ExprHashString(flatExpr),
|
||||
GroupRatio: 1.0,
|
||||
},
|
||||
}
|
||||
|
||||
ok, _, _ := TryTieredSettle(info, billingexpr.TokenParams{P: 1000, C: 500})
|
||||
if ok {
|
||||
t.Fatal("expected TryTieredSettle to return false for empty billing mode")
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Fallback tests
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
func TestTryTieredSettle_ErrorFallbackToEstimatedQuotaAfterGroup(t *testing.T) {
|
||||
info := &relaycommon.RelayInfo{
|
||||
FinalPreConsumedQuota: 0,
|
||||
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
|
||||
BillingMode: "tiered_expr",
|
||||
ExprString: `invalid expr!!!`,
|
||||
ExprHash: billingexpr.ExprHashString(`invalid expr!!!`),
|
||||
GroupRatio: 1.0,
|
||||
EstimatedQuotaAfterGroup: 999,
|
||||
},
|
||||
}
|
||||
|
||||
ok, quota, result := TryTieredSettle(info, billingexpr.TokenParams{P: 100})
|
||||
if !ok {
|
||||
t.Fatal("expected tiered settle to apply")
|
||||
}
|
||||
// FinalPreConsumedQuota is 0, should fall back to EstimatedQuotaAfterGroup
|
||||
if quota != 999 {
|
||||
t.Fatalf("quota = %d, want 999", quota)
|
||||
}
|
||||
if result != nil {
|
||||
t.Fatal("result should be nil on error fallback")
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user