餘額與配額
最後更新
哪些供應商套件提供 Usage 函式，以及各自填入 UsageRemaining 的哪些欄位。
簽名
下列套件都匯出同一個函式：
func Usage(ctx context.Context, config llmrouter.Config) (llmrouter.UsageRemaining, error)
type UsageRemaining struct {
FiveHour *float64 `json:"five_hour,omitempty"` // 5 小時視窗剩餘百分比
Week *float64 `json:"week,omitempty"` // 週視窗剩餘百分比
Balance *float64 `json:"balance,omitempty"` // 帳戶餘額或剩餘點數
Total *float64 `json:"total,omitempty"` // 整體配額剩餘百分比
}
各供應商只填入自家回報的欄位，其餘維持 nil，取值前須先判斷。
各套件填入欄位
| 套件 | 憑證 | 填入欄位 |
|---|---|---|
core/openRouter |
APIKey |
Balance = total_credits - total_usage |
core/deepseek |
APIKey |
Balance = 第一筆 balance_infos[].total_balance |
core/ollamaCloud |
APIKey |
Total = (1 - limits.monthly.usage) * 100 |
core/copilot |
Token |
Total = Chat 或 premium interactions 剩餘百分比 |
core/openaiCodex |
APIKey，AccountID 選填 |
FiveHour / Week = 主／次 rate-limit 視窗的 100 - used_percent |
core/grokOauth |
APIKey |
Total = 剩餘點數百分比 |
缺少憑證時在送出請求前直接回錯。
範例
remaining, err := openaiCodex.Usage(ctx, llmrouter.Config{APIKey: token.AccessToken, AccountID: token.AccountID})
if err != nil {
return err
}
if remaining.FiveHour != nil && remaining.Week != nil {
fmt.Printf("5h: %.0f%% left, week: %.0f%% left\n", *remaining.FiveHour, *remaining.Week)
}