Files
new-api/service/tiered_settle_test.go
T
Calcium-Ion cfaba1dd67 fix(billing): harden tiered retry group-switch billing (#6570)
Follow-up to #6518 (issue #6480) addressing three review findings:

- Document and lock in arrears semantics for the wallet Reserve top-up:
  when an auto-group retry lands on a more expensive group, the full
  reservation delta is deducted unconditionally (balance may go
  negative), mirroring settlement, so the logged pre-consumed quota
  always reconciles with the actual balance movement. Genuine DB
  errors still fail the attempt with update_data_error. Subscription
  funding keeps its insufficient-quota behavior: subscriptions enforce
  a hard used<=total cap and do not support arrears.
- PriceData.FreeModel is cleared when a retry switches from a free
  group to a paid one, keeping it consistent with the billing session
  created at that point.
- getChannel refreshes GroupRatioInfo only after channel selection
  succeeds, and the retry loop records the channel in use_channel
  before PrepareTieredBillingForSelectedGroup can fail.
2026-08-01 09:35:51 +08:00

1027 lines
33 KiB
Go

package service
import (
"math"
"math/rand"
"testing"
"github.com/QuantumNous/new-api/model"
"github.com/QuantumNous/new-api/pkg/billingexpr"
relaycommon "github.com/QuantumNous/new-api/relay/common"
"github.com/QuantumNous/new-api/relaykit/dto"
"github.com/QuantumNous/new-api/types"
"github.com/gin-gonic/gin"
"github.com/shopspring/decimal"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// 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)`
const testQuotaPerUnit = 500_000.0
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,
QuotaPerUnit: testQuotaPerUnit,
}
}
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)})
quotaBeforeGroup := cost / 1_000_000 * testQuotaPerUnit
snap.EstimatedQuotaBeforeGroup = quotaBeforeGroup
snap.EstimatedQuotaAfterGroup = billingexpr.QuotaRound(quotaBeforeGroup * 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: 50,
QuotaPerUnit: testQuotaPerUnit,
},
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")
}
// fast: p*2 = 200; quota = 200 / 1M * 500K = 100
if quota != 100 {
t.Fatalf("quota = %d, want 100", 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 = 7000; quota = 7000 / 1M * 500K = 3500
if quota != 3500 {
t.Fatalf("quota = %d, want 3500", 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 // 3500
// 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 = 14000; quota = 14000 / 1M * 500K = 7000
if quota != 7000 {
t.Fatalf("quota = %d, want 7000", 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 // 3500
// 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 = 700; quota = 700 / 1M * 500K = 350
if quota != 350 {
t.Fatalf("quota = %d, want 350", 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 = 307500; quota = 307500 / 1M * 500K = 153750
if quota != 153750 {
t.Fatalf("quota = %d, want 153750", 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 = 611253; quota = round(611253 / 1M * 500K) = 305627
if quota != 305627 {
t.Fatalf("quota = %d, want 305627", 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 = 70000000; quota = 70000000 / 1M * 500K = 35000000
if quota != 35000000 {
t.Fatalf("quota = %d, want 35000000", 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 = 7000; quota = 7000 / 1M * 500K = 3500
// 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 + 2000 + 12500 + 8000 = 29500; quota = 29500 / 1M * 500K = 14750
if quota2 <= quota1 {
t.Fatalf("cache tokens should increase quota: without=%d, with=%d", quota1, quota2)
}
if quota1 != 3500 {
t.Fatalf("no-cache quota = %d, want 3500", quota1)
}
if quota2 != 14750 {
t.Fatalf("cache quota = %d, want 14750", 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 = 14000; quota = 14000 / 1M * 500K = 7000
if quota != 7000 {
t.Fatalf("quota = %d, want 7000", 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 = 7000; quota = 7000 / 1M * 500K = 3500
if quota != 3500 {
t.Fatalf("quota = %d, want 3500", quota)
}
if result.MatchedTier != "normal" {
t.Fatalf("tier = %s, want normal", result.MatchedTier)
}
}
// ---------------------------------------------------------------------------
// Group ratio tests
// ---------------------------------------------------------------------------
type recordingBillingSettler struct {
preConsumedQuota int
reserveTargets []int
}
func (*recordingBillingSettler) Settle(int) error { return nil }
func (*recordingBillingSettler) Refund(*gin.Context) {}
func (*recordingBillingSettler) NeedsRefund() bool { return false }
func (s *recordingBillingSettler) GetPreConsumedQuota() int {
return s.preConsumedQuota
}
func (s *recordingBillingSettler) Reserve(targetQuota int) error {
s.reserveTargets = append(s.reserveTargets, targetQuota)
if targetQuota > s.preConsumedQuota {
s.preConsumedQuota = targetQuota
}
return nil
}
func TestPrepareTieredBillingForSelectedGroupUpdatesReservation(t *testing.T) {
const expr = `tier("base", p)`
billing := &recordingBillingSettler{preConsumedQuota: 50_000}
relayInfo := &relaycommon.RelayInfo{
Billing: billing,
FinalPreConsumedQuota: 50_000,
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
BillingMode: "tiered_expr",
ExprString: expr,
ExprHash: billingexpr.ExprHashString(expr),
GroupRatio: 0.10,
EstimatedQuotaBeforeGroup: 500_000,
EstimatedQuotaAfterGroup: 50_000,
QuotaPerUnit: testQuotaPerUnit,
},
PriceData: types.PriceData{
GroupRatioInfo: types.GroupRatioInfo{GroupRatio: 0.20},
},
}
require.Nil(t, PrepareTieredBillingForSelectedGroup(nil, relayInfo))
require.Equal(t, []int{100_000}, billing.reserveTargets)
assert.Equal(t, 100_000, billing.preConsumedQuota)
assert.Equal(t, 100_000, relayInfo.FinalPreConsumedQuota)
assert.Equal(t, 0.20, relayInfo.TieredBillingSnapshot.GroupRatio)
assert.Equal(t, 100_000, relayInfo.TieredBillingSnapshot.EstimatedQuotaAfterGroup)
}
func TestPrepareTieredBillingForSelectedGroupStartsBillingAfterFreeGroup(t *testing.T) {
truncate(t)
gin.SetMode(gin.TestMode)
const userID = 700
seedUser(t, userID, 500_000)
relayInfo := &relaycommon.RelayInfo{
UserId: userID,
IsPlayground: true,
ForcePreConsume: true,
OriginModelName: "gpt-test",
UserSetting: dto.UserSetting{
BillingPreference: "wallet_only",
},
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
BillingMode: "tiered_expr",
ExprString: `tier("base", p)`,
ExprHash: billingexpr.ExprHashString(`tier("base", p)`),
GroupRatio: 0,
EstimatedQuotaBeforeGroup: 500_000,
QuotaPerUnit: testQuotaPerUnit,
},
PriceData: types.PriceData{
FreeModel: true,
GroupRatioInfo: types.GroupRatioInfo{GroupRatio: 0.20},
},
}
ctx, _ := gin.CreateTestContext(nil)
require.Nil(t, PrepareTieredBillingForSelectedGroup(ctx, relayInfo))
require.NotNil(t, relayInfo.Billing)
assert.False(t, relayInfo.PriceData.FreeModel, "FreeModel must be cleared after switching to a paid group")
assert.Equal(t, 100_000, relayInfo.FinalPreConsumedQuota)
assert.Equal(t, 0.20, relayInfo.TieredBillingSnapshot.GroupRatio)
assert.Equal(t, 100_000, relayInfo.TieredBillingSnapshot.EstimatedQuotaAfterGroup)
userQuota, err := model.GetUserQuota(userID, false)
require.NoError(t, err)
assert.Equal(t, 400_000, userQuota)
}
func TestPrepareTieredBillingForSelectedGroupPaidToFreeKeepsFreeModelFalse(t *testing.T) {
const expr = `tier("base", p)`
billing := &recordingBillingSettler{preConsumedQuota: 50_000}
relayInfo := &relaycommon.RelayInfo{
Billing: billing,
FinalPreConsumedQuota: 50_000,
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
BillingMode: "tiered_expr",
ExprString: expr,
ExprHash: billingexpr.ExprHashString(expr),
GroupRatio: 0.10,
EstimatedQuotaBeforeGroup: 500_000,
EstimatedQuotaAfterGroup: 50_000,
QuotaPerUnit: testQuotaPerUnit,
},
PriceData: types.PriceData{
GroupRatioInfo: types.GroupRatioInfo{GroupRatio: 0},
},
}
require.Nil(t, PrepareTieredBillingForSelectedGroup(nil, relayInfo))
// Pre-consume did happen under the paid group, so FreeModel stays false;
// settlement already yields 0 for GroupRatio == 0 and the session refunds.
assert.False(t, relayInfo.PriceData.FreeModel)
assert.Empty(t, billing.reserveTargets)
assert.Equal(t, 50_000, relayInfo.FinalPreConsumedQuota)
}
func TestPrepareTieredBillingForSelectedGroupTopUpArrearsAllowsNegativeBalance(t *testing.T) {
truncate(t)
const userID = 701
// Balance covers the initial 50k pre-consume (already deducted before this
// test's seed) but not the 50k top-up to the more expensive retry group.
// The top-up must NOT abort the request: the full delta is deducted, the
// uncovered 30k becomes arrears (negative balance), mirroring how
// settlement charges a positive delta unconditionally.
seedUser(t, userID, 20_000)
relayInfo := &relaycommon.RelayInfo{
UserId: userID,
IsPlayground: true,
FinalPreConsumedQuota: 50_000,
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
BillingMode: "tiered_expr",
ExprString: `tier("base", p)`,
ExprHash: billingexpr.ExprHashString(`tier("base", p)`),
GroupRatio: 0.10,
EstimatedQuotaBeforeGroup: 500_000,
EstimatedQuotaAfterGroup: 50_000,
QuotaPerUnit: testQuotaPerUnit,
},
PriceData: types.PriceData{
GroupRatioInfo: types.GroupRatioInfo{GroupRatio: 0.20},
},
}
session := &BillingSession{
relayInfo: relayInfo,
funding: &WalletFunding{userId: userID, consumed: 50_000},
preConsumedQuota: 50_000,
}
relayInfo.Billing = session
require.Nil(t, PrepareTieredBillingForSelectedGroup(nil, relayInfo))
// Full reservation recorded; wallet charged the full delta into arrears.
assert.Equal(t, 100_000, session.GetPreConsumedQuota())
assert.Equal(t, 100_000, relayInfo.FinalPreConsumedQuota)
assert.Equal(t, 100_000, relayInfo.TieredBillingSnapshot.EstimatedQuotaAfterGroup)
userQuota, err := model.GetUserQuota(userID, false)
require.NoError(t, err)
assert.Equal(t, -30_000, userQuota)
// Settlement still reconciles against the full reservation: actual 80k
// refunds the 20k over-reserve, landing at seed - (actual - initial) = -10k.
require.NoError(t, session.Settle(80_000))
userQuota, err = model.GetUserQuota(userID, false)
require.NoError(t, err)
assert.Equal(t, -10_000, userQuota)
}
func TestBillingSessionReserveWalletTopUpDecrementsBalance(t *testing.T) {
truncate(t)
const userID = 702
seedUser(t, userID, 500_000)
relayInfo := &relaycommon.RelayInfo{
UserId: userID,
IsPlayground: true,
}
session := &BillingSession{
relayInfo: relayInfo,
funding: &WalletFunding{userId: userID, consumed: 50_000},
preConsumedQuota: 50_000,
}
require.NoError(t, session.Reserve(100_000))
assert.Equal(t, 100_000, session.GetPreConsumedQuota())
assert.Equal(t, 100_000, relayInfo.FinalPreConsumedQuota)
userQuota, err := model.GetUserQuota(userID, false)
require.NoError(t, err)
assert.Equal(t, 450_000, userQuota)
}
func TestTryTieredSettleUsesFinalGroupAfterRetry(t *testing.T) {
const expr = `tier("base", p)`
tests := []struct {
name string
finalGroupRatio float64
wantQuota int
}{
{name: "more expensive final group", finalGroupRatio: 0.20, wantQuota: 100_000},
{name: "free final group", finalGroupRatio: 0, wantQuota: 0},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
relayInfo := &relaycommon.RelayInfo{
Billing: &recordingBillingSettler{preConsumedQuota: 50_000},
FinalPreConsumedQuota: 50_000,
TieredBillingSnapshot: &billingexpr.BillingSnapshot{
BillingMode: "tiered_expr",
ExprString: expr,
ExprHash: billingexpr.ExprHashString(expr),
GroupRatio: 0.10,
EstimatedQuotaBeforeGroup: 500_000,
EstimatedQuotaAfterGroup: 50_000,
QuotaPerUnit: testQuotaPerUnit,
},
PriceData: types.PriceData{
GroupRatioInfo: types.GroupRatioInfo{GroupRatio: tt.finalGroupRatio},
},
}
require.Nil(t, PrepareTieredBillingForSelectedGroup(nil, relayInfo))
ok, quota, result := TryTieredSettle(relayInfo, billingexpr.TokenParams{P: 1_000_000})
require.True(t, ok)
require.NotNil(t, result)
assert.Equal(t, tt.wantQuota, quota)
assert.Equal(t, tt.finalGroupRatio, relayInfo.TieredBillingSnapshot.GroupRatio)
assert.Equal(t, tt.wantQuota, relayInfo.TieredBillingSnapshot.EstimatedQuotaAfterGroup)
})
}
}
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")
}
// exprCost = 7000, quotaBeforeGroup = 3500, afterGroup = round(3500 * 1.5) = 5250
if quota != 5250 {
t.Fatalf("quota = %d, want 5250", 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")
}
}
// ---------------------------------------------------------------------------
// BuildTieredTokenParams: token normalization and ratio parity tests
// ---------------------------------------------------------------------------
func tieredQuota(exprStr string, usage *dto.Usage, isClaudeSemantic bool, groupRatio float64) float64 {
usedVars := billingexpr.UsedVars(exprStr)
params := BuildTieredTokenParams(usage, isClaudeSemantic, usedVars)
cost, _, _ := billingexpr.RunExpr(exprStr, params)
return cost / 1_000_000 * testQuotaPerUnit * groupRatio
}
func ratioQuota(usage *dto.Usage, isClaudeSemantic bool, modelRatio, completionRatio, cacheRatio, imageRatio, groupRatio float64) float64 {
dPromptTokens := decimal.NewFromInt(int64(usage.PromptTokens))
dCacheTokens := decimal.NewFromInt(int64(usage.PromptTokensDetails.CachedTokens))
dCcTokens := decimal.NewFromInt(int64(usage.PromptTokensDetails.CachedCreationTokens))
dImgTokens := decimal.NewFromInt(int64(usage.PromptTokensDetails.ImageTokens))
dCompletionTokens := decimal.NewFromInt(int64(usage.CompletionTokens))
dModelRatio := decimal.NewFromFloat(modelRatio)
dCompletionRatio := decimal.NewFromFloat(completionRatio)
dCacheRatio := decimal.NewFromFloat(cacheRatio)
dImageRatio := decimal.NewFromFloat(imageRatio)
dGroupRatio := decimal.NewFromFloat(groupRatio)
baseTokens := dPromptTokens
if !isClaudeSemantic {
baseTokens = baseTokens.Sub(dCacheTokens)
baseTokens = baseTokens.Sub(dCcTokens)
baseTokens = baseTokens.Sub(dImgTokens)
}
cachedTokensWithRatio := dCacheTokens.Mul(dCacheRatio)
imageTokensWithRatio := dImgTokens.Mul(dImageRatio)
promptQuota := baseTokens.Add(cachedTokensWithRatio).Add(imageTokensWithRatio)
completionQuota := dCompletionTokens.Mul(dCompletionRatio)
ratio := dModelRatio.Mul(dGroupRatio)
result := promptQuota.Add(completionQuota).Mul(ratio)
f, _ := result.Float64()
return f
}
func TestBuildTieredTokenParams_GPT_WithCache(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 1000,
CompletionTokens: 500,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 200,
TextTokens: 800,
},
}
expr := `tier("base", p * 2.5 + c * 15 + cr * 0.25)`
got := tieredQuota(expr, usage, false, 1.0)
// P=800, C=500, CR=200 → (800*2.5 + 500*15 + 200*0.25) * 0.5 = 4775
want := 4775.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_GPT_NoCacheVar(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 1000,
CompletionTokens: 500,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 200,
TextTokens: 800,
},
}
expr := `tier("base", p * 2.5 + c * 15)`
got := tieredQuota(expr, usage, false, 1.0)
// No cr → P=1000 (cache stays in P), C=500 → (1000*2.5 + 500*15) * 0.5 = 5000
want := 5000.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_GPT_WithImage(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 1000,
CompletionTokens: 500,
PromptTokensDetails: dto.InputTokenDetails{
ImageTokens: 200,
TextTokens: 800,
},
}
expr := `tier("base", p * 2 + c * 8 + img * 2.5)`
got := tieredQuota(expr, usage, false, 1.0)
// P=800, C=500, Img=200 → (800*2 + 500*8 + 200*2.5) * 0.5 = 3050
want := 3050.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_Claude_WithCache(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 800,
CompletionTokens: 500,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 200,
TextTokens: 800,
},
}
expr := `tier("base", p * 3 + c * 15 + cr * 0.3)`
got := tieredQuota(expr, usage, true, 1.0)
// Claude: P=800 (no subtraction), C=500, CR=200 → (800*3 + 500*15 + 200*0.3) * 0.5 = 4980
want := 4980.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_GPT_AudioOutput(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 1000,
CompletionTokens: 600,
CompletionTokenDetails: dto.OutputTokenDetails{
AudioTokens: 100,
TextTokens: 500,
},
}
expr := `tier("base", p * 2 + c * 10 + ao * 50)`
got := tieredQuota(expr, usage, false, 1.0)
// C=600-100=500, AO=100 → (1000*2 + 500*10 + 100*50) * 0.5 = 6000
want := 6000.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_GPT_AudioOutputNoVar(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 1000,
CompletionTokens: 600,
CompletionTokenDetails: dto.OutputTokenDetails{
AudioTokens: 100,
TextTokens: 500,
},
}
expr := `tier("base", p * 2 + c * 10)`
got := tieredQuota(expr, usage, false, 1.0)
// No ao → C=600 (audio stays in C) → (1000*2 + 600*10) * 0.5 = 4000
want := 4000.0
if math.Abs(got-want) > 0.01 {
t.Fatalf("quota = %f, want %f", got, want)
}
}
func TestBuildTieredTokenParams_ParityWithRatio(t *testing.T) {
// GPT-5.4 prices: input=$2.5, output=$15, cacheRead=$0.25
// Ratio equivalents: modelRatio=1.25, completionRatio=6, cacheRatio=0.1
usage := &dto.Usage{
PromptTokens: 10000,
CompletionTokens: 2000,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 3000,
TextTokens: 7000,
},
}
expr := `tier("base", p * 2.5 + c * 15 + cr * 0.25)`
for _, gr := range []float64{1.0, 1.5, 2.0, 0.5} {
tq := tieredQuota(expr, usage, false, gr)
rq := ratioQuota(usage, false, 1.25, 6, 0.1, 0, gr)
if math.Abs(tq-rq) > 0.01 {
t.Fatalf("groupRatio=%v: tiered=%f ratio=%f (mismatch)", gr, tq, rq)
}
}
}
func TestBuildTieredTokenParams_ParityWithRatio_Image(t *testing.T) {
// gpt-image-1-mini prices: input=$2, output=$8, image=$2.5
// Ratio equivalents: modelRatio=1, completionRatio=4, imageRatio=1.25
usage := &dto.Usage{
PromptTokens: 5000,
CompletionTokens: 4000,
PromptTokensDetails: dto.InputTokenDetails{
ImageTokens: 1000,
TextTokens: 4000,
},
}
expr := `tier("base", p * 2 + c * 8 + img * 2.5)`
tq := tieredQuota(expr, usage, false, 1.0)
rq := ratioQuota(usage, false, 1.0, 4, 0, 1.25, 1.0)
if math.Abs(tq-rq) > 0.01 {
t.Fatalf("tiered=%f ratio=%f (mismatch)", tq, rq)
}
}
// ---------------------------------------------------------------------------
// BuildTieredTokenParams: Len computation tests
// ---------------------------------------------------------------------------
func TestBuildTieredTokenParams_Len_GPT(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 10000,
CompletionTokens: 2000,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 3000,
TextTokens: 7000,
},
}
expr := `tier("base", p * 2.5 + c * 15 + cr * 0.25)`
usedVars := billingexpr.UsedVars(expr)
params := BuildTieredTokenParams(usage, false, usedVars)
// Non-Claude: Len = raw PromptTokens
if params.Len != 10000 {
t.Fatalf("Len = %f, want 10000 (raw PromptTokens)", params.Len)
}
// P should be reduced by cache
if params.P != 7000 {
t.Fatalf("P = %f, want 7000 (PromptTokens - CachedTokens)", params.P)
}
}
func TestBuildTieredTokenParams_Len_Claude(t *testing.T) {
usage := &dto.Usage{
PromptTokens: 5000,
CompletionTokens: 2000,
UsageSemantic: "anthropic",
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 3000,
TextTokens: 5000,
},
ClaudeCacheCreation5mTokens: 1000,
ClaudeCacheCreation1hTokens: 500,
}
expr := `tier("base", p * 3 + c * 15 + cr * 0.3 + cc * 3.75 + cc1h * 6)`
usedVars := billingexpr.UsedVars(expr)
params := BuildTieredTokenParams(usage, true, usedVars)
// Claude: Len = PromptTokens + CachedTokens + CacheCreation5m + CacheCreation1h
wantLen := float64(5000 + 3000 + 1000 + 500)
if params.Len != wantLen {
t.Fatalf("Len = %f, want %f (text + cache read + cache creation)", params.Len, wantLen)
}
// Claude: P is not reduced (isClaudeUsageSemantic = true)
if params.P != 5000 {
t.Fatalf("P = %f, want 5000 (no subtraction for Claude)", params.P)
}
}
func TestBuildTieredTokenParams_Len_TierCondition(t *testing.T) {
// Test that len-based tier conditions work correctly when p is reduced by cache
usage := &dto.Usage{
PromptTokens: 300000,
CompletionTokens: 5000,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: 250000,
TextTokens: 50000,
},
}
expr := `len <= 200000 ? tier("standard", p * 3 + c * 15 + cr * 0.3) : tier("long_context", p * 6 + c * 22.5 + cr * 0.6)`
usedVars := billingexpr.UsedVars(expr)
params := BuildTieredTokenParams(usage, false, usedVars)
// Len = 300000 (raw prompt), P = 50000 (300000 - 250000 cache)
if params.Len != 300000 {
t.Fatalf("Len = %f, want 300000", params.Len)
}
if params.P != 50000 {
t.Fatalf("P = %f, want 50000", params.P)
}
// Run expression: len=300000 > 200000, so long_context tier
cost, trace, err := billingexpr.RunExpr(expr, params)
if err != nil {
t.Fatal(err)
}
if trace.MatchedTier != "long_context" {
t.Fatalf("tier = %s, want long_context (len=300000 but p=50000)", trace.MatchedTier)
}
// long_context: 50000*6 + 5000*22.5 + 250000*0.6
wantCost := 50000.0*6 + 5000*22.5 + 250000*0.6
if math.Abs(cost-wantCost) > 1e-6 {
t.Fatalf("cost = %f, want %f", cost, wantCost)
}
}
const complexTieredExpr = `p <= 200000 ? tier("standard", p * 3 + c * 15 + cr * 0.3 + cc * 3.75 + cc1h * 6 + img * 3 + img_o * 30 + ai * 10 + ao * 40) : tier("long_context", p * 6 + c * 22.5 + cr * 0.6 + cc * 7.5 + cc1h * 12 + img * 6 + img_o * 60 + ai * 20 + ao * 80)`
func randomUsage(rng *rand.Rand) *dto.Usage {
cacheRead := int(rng.Float64() * 50000)
cacheCreate := int(rng.Float64() * 10000)
imgIn := int(rng.Float64() * 5000)
audioIn := int(rng.Float64() * 3000)
prompt := int(rng.Float64()*300000) + cacheRead + cacheCreate + imgIn + audioIn
imgOut := int(rng.Float64() * 2000)
audioOut := int(rng.Float64() * 1000)
completion := int(rng.Float64()*50000) + imgOut + audioOut
return &dto.Usage{
PromptTokens: prompt,
CompletionTokens: completion,
PromptTokensDetails: dto.InputTokenDetails{
CachedTokens: cacheRead,
CachedCreationTokens: cacheCreate,
ImageTokens: imgIn,
AudioTokens: audioIn,
TextTokens: prompt - cacheRead - cacheCreate - imgIn - audioIn,
},
CompletionTokenDetails: dto.OutputTokenDetails{
ImageTokens: imgOut,
AudioTokens: audioOut,
TextTokens: completion - imgOut - audioOut,
},
}
}
func BenchmarkTieredBilling_ComplexExpr(b *testing.B) {
rng := rand.New(rand.NewSource(42))
usedVars := billingexpr.UsedVars(complexTieredExpr)
usages := make([]*dto.Usage, 1000)
for i := range usages {
usages[i] = randomUsage(rng)
}
b.ResetTimer()
for i := 0; i < b.N; i++ {
usage := usages[i%len(usages)]
params := BuildTieredTokenParams(usage, false, usedVars)
billingexpr.RunExpr(complexTieredExpr, params)
}
}
func BenchmarkRatioBilling_Equivalent(b *testing.B) {
rng := rand.New(rand.NewSource(42))
usages := make([]*dto.Usage, 1000)
for i := range usages {
usages[i] = randomUsage(rng)
}
b.ResetTimer()
for i := 0; i < b.N; i++ {
usage := usages[i%len(usages)]
ratioQuota(usage, false, 1.5, 5.0, 0.1, 1.0, 1.5)
}
}
func BenchmarkTieredBilling_Parallel(b *testing.B) {
usedVars := billingexpr.UsedVars(complexTieredExpr)
b.RunParallel(func(pb *testing.PB) {
rng := rand.New(rand.NewSource(rand.Int63()))
for pb.Next() {
usage := randomUsage(rng)
params := BuildTieredTokenParams(usage, false, usedVars)
billingexpr.RunExpr(complexTieredExpr, params)
}
})
}
func BenchmarkRatioBilling_Parallel(b *testing.B) {
b.RunParallel(func(pb *testing.PB) {
rng := rand.New(rand.NewSource(rand.Int63()))
for pb.Next() {
usage := randomUsage(rng)
ratioQuota(usage, false, 1.5, 5.0, 0.1, 1.0, 1.5)
}
})
}