From 4d1478feb6ccfb0b1122413313777d0f9a671ca7 Mon Sep 17 00:00:00 2001
From: Jeff Gu <idevs@foxmail.com>
Date: Tue, 14 Apr 2026 17:59:03 +0800
Subject: [PATCH] =?UTF-8?q?feat(token):=20=E6=94=AF=E6=8C=81=E6=97=A0?=
 =?UTF-8?q?=E9=99=90=E9=A2=9D=E5=BA=A6=E7=9A=84=E6=80=BB=E9=85=8D=E9=A2=9D?=
 =?UTF-8?q?=E8=AE=BE=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 修改 TokenConfig 接口，允许 total_quota 为 -1 表示无限额度
- 更新 TokenUpsertEndpoint，处理新的 total_quota 验证逻辑
- 添加 TokenUtils 中的 normalizeQuota 方法，规范化配额值
- 在模型处理逻辑中检查剩余配额，确保按需收费
- 更新相关文档以反映新的配额逻辑
---
 frontend/src/pages/Channels.tsx          |  61 +-
 frontend/src/pages/Tokens.tsx            | 837 +++++++++++++----------
 frontend/src/types/index.ts              |   2 +-
 src/admin/token_api.ts                   |  20 +-
 src/admin/token_utils.ts                 |  68 ++
 src/providers/models.ts                  |   5 +
 src/providers/shared/channel-resolver.ts |  23 +-
 type.d.ts                                |   2 +-
 8 files changed, 598 insertions(+), 420 deletions(-)

diff --git a/frontend/src/pages/Channels.tsx b/frontend/src/pages/Channels.tsx
index 1cdf6a8..a00d2a8 100644
--- a/frontend/src/pages/Channels.tsx
+++ b/frontend/src/pages/Channels.tsx
@@ -5,6 +5,7 @@ import { apiClient } from "@/api/client";
 import { Channel, ChannelConfig, ChannelModelMapping } from "@/types";
 import { Card, CardContent } from "@/components/ui/card";
 import { Button } from "@/components/ui/button";
+import { ButtonGroup } from "@/components/ui/button-group";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { Select } from "@/components/ui/select";
@@ -49,10 +50,15 @@ const channelTypes = [
 ];
 
 const channelWeightOptions = Array.from({ length: 6 }, (_, weight) => ({
-  value: String(weight),
-  label: `权重 ${weight}`,
+  value: weight,
+  label: String(weight),
 }));
 
+const modelEditorModeOptions = [
+  { value: "visual", label: "可视化" },
+  { value: "json", label: "JSON" },
+] as const;
+
 const createEmptyModelRow = (): ModelRow => ({
   id: "",
   name: "",
@@ -1007,7 +1013,9 @@ export function Channels({ createMode = false, editRoute = false }: { createMode
                 const modelCount = (config.models || []).length;
                 const enabledModelCount = (config.models || []).filter((model) => model.enabled !== false).length;
                 const modelSummary =
-                  enabledModelCount === modelCount ? `${modelCount} 个模型` : `${enabledModelCount}/${modelCount} 个模型`;
+                  enabledModelCount === modelCount
+                    ? `${modelCount} 个模型`
+                    : `${enabledModelCount}/${modelCount} 个模型`;
                 const isMenuOpen = openMenu === channel.key;
                 const isEnabled = config.enabled !== false;
                 const isToggling =
@@ -1226,21 +1234,19 @@ export function Channels({ createMode = false, editRoute = false }: { createMode
                     </div>
                     <div className="space-y-2">
                       <Label className="text-sm">渠道权重</Label>
-                      <Select
-                        value={String(formData.weight ?? 0)}
-                        onChange={(event) =>
+                      <ButtonGroup
+                        aria-label="渠道权重"
+                        value={normalizeChannelWeight(formData.weight)}
+                        options={channelWeightOptions}
+                        onValueChange={(value) =>
                           setFormData({
                             ...formData,
-                            weight: normalizeChannelWeight(Number(event.target.value)),
+                            weight: normalizeChannelWeight(value),
                           })
                         }
-                      >
-                        {channelWeightOptions.map((option) => (
-                          <option key={option.value} value={option.value}>
-                            {option.label}
-                          </option>
-                        ))}
-                      </Select>
+                        className="flex h-10 items-center px-2 gap-1"
+                        buttonClassName="rounded-sm w-8 h-6 data-[state=on]:bg-amber-600 data-[state=on]:text-white"
+                      />
                       <p className="text-xs text-muted-foreground">相同模型权重优先，相同权重随机分配。</p>
                     </div>
                     <div className="">
@@ -1330,7 +1336,9 @@ export function Channels({ createMode = false, editRoute = false }: { createMode
                         />
                         <div>
                           <div className="text-sm font-medium">自动轮换</div>
-                          <p className="mt-1 text-xs text-muted-foreground">重试时随机切换同渠道其他密钥；关闭后始终重试当前密钥</p>
+                          <p className="mt-1 text-xs text-muted-foreground">
+                            重试时随机切换同渠道其他密钥；关闭后始终重试当前密钥
+                          </p>
                         </div>
                       </label>
                     </div>
@@ -1351,22 +1359,13 @@ export function Channels({ createMode = false, editRoute = false }: { createMode
                       </p>
                     </div>
                     <div className="flex flex-wrap items-center gap-2">
-                      <Button
-                        type="button"
-                        variant={modelEditorMode === "visual" ? "secondary" : "outline"}
-                        size="sm"
-                        onClick={() => setModelEditorModeWithSync("visual")}
-                      >
-                        可视化
-                      </Button>
-                      <Button
-                        type="button"
-                        variant={modelEditorMode === "json" ? "secondary" : "outline"}
-                        size="sm"
-                        onClick={() => setModelEditorModeWithSync("json")}
-                      >
-                        JSON
-                      </Button>
+                      <ButtonGroup
+                        aria-label="模型配置编辑模式"
+                        value={modelEditorMode}
+                        options={modelEditorModeOptions}
+                        onValueChange={setModelEditorModeWithSync}
+                        activeVariant="secondary"
+                      />
                       <Button
                         type="button"
                         variant="outline"
diff --git a/frontend/src/pages/Tokens.tsx b/frontend/src/pages/Tokens.tsx
index 8752dd9..8bdb746 100644
--- a/frontend/src/pages/Tokens.tsx
+++ b/frontend/src/pages/Tokens.tsx
@@ -1,17 +1,18 @@
-import { useCallback, useEffect, useState } from 'react'
-import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
-import { useNavigate, useParams } from 'react-router-dom'
-import { apiClient } from '@/api/client'
-import { Token, TokenConfig, Channel } from '@/types'
-import { Card, CardContent } from '@/components/ui/card'
-import { Button } from '@/components/ui/button'
-import { Input } from '@/components/ui/input'
-import { Label } from '@/components/ui/label'
-import { Textarea } from '@/components/ui/textarea'
-import { useToast } from '@/components/ui/use-toast'
-import { useBillingConfig } from '@/hooks/use-billing-config'
-import { DEFAULT_BILLING_DISPLAY_DECIMALS, rawBillingToUsd, usdToRawBilling } from '@/lib/billing'
-import { formatCurrency, copyToClipboard, generateTokenKey, cn } from '@/lib/utils'
+import { useCallback, useEffect, useState } from "react";
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useNavigate, useParams } from "react-router-dom";
+import { apiClient } from "@/api/client";
+import { Token, TokenConfig, Channel } from "@/types";
+import { Card, CardContent } from "@/components/ui/card";
+import { Button } from "@/components/ui/button";
+import { ButtonGroup } from "@/components/ui/button-group";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { useToast } from "@/components/ui/use-toast";
+import { useBillingConfig } from "@/hooks/use-billing-config";
+import { DEFAULT_BILLING_DISPLAY_DECIMALS, rawBillingToUsd, usdToRawBilling } from "@/lib/billing";
+import { formatCurrency, copyToClipboard, generateTokenKey, cn } from "@/lib/utils";
 import {
   Plus,
   RefreshCw,
@@ -28,291 +29,336 @@ import {
   AlertCircle,
   Search,
   RotateCcw,
-} from 'lucide-react'
-import { Checkbox } from '@/components/ui/checkbox'
-import { PageContainer } from '@/components/ui/page-container'
+} from "lucide-react";
+import { Checkbox } from "@/components/ui/checkbox";
+import { PageContainer } from "@/components/ui/page-container";
 
-type EditMode = 'form' | 'json'
-const INTEGER_QUOTA_PATTERN = /^\d*$/
+type EditMode = "form" | "json";
+const UNLIMITED_TOKEN_QUOTA = -1;
+const QUOTA_INPUT_PATTERN = /^-?\d*$/;
 
 const formatQuotaInputValue = (value: number): string => {
-  return String(Math.max(0, Math.round(rawBillingToUsd(value))))
-}
+  if (value === UNLIMITED_TOKEN_QUOTA) {
+    return "-1";
+  }
 
-const parseQuotaInputValue = (value: string): number => {
-  const parsed = Number.parseInt(value || '0', 10)
-  return usdToRawBilling(Number.isFinite(parsed) ? Math.max(0, parsed) : 0)
-}
+  return String(Math.max(0, Math.round(rawBillingToUsd(value))));
+};
+
+const parseQuotaInputValue = (value: string): number | null => {
+  const trimmedValue = value.trim();
+  if (!trimmedValue) {
+    return 0;
+  }
+
+  if (trimmedValue === "-1") {
+    return UNLIMITED_TOKEN_QUOTA;
+  }
+
+  const parsed = Number.parseInt(trimmedValue, 10);
+  if (!Number.isFinite(parsed) || parsed < 0) {
+    return null;
+  }
+
+  return usdToRawBilling(parsed);
+};
+
+const normalizeTokenQuota = (value: unknown): number => {
+  const parsed = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(parsed)) {
+    return 0;
+  }
+
+  if (Math.round(parsed) === UNLIMITED_TOKEN_QUOTA) {
+    return UNLIMITED_TOKEN_QUOTA;
+  }
+
+  return Math.max(0, Math.round(parsed));
+};
+
+const isUnlimitedTokenQuota = (value: number): boolean => {
+  return value === UNLIMITED_TOKEN_QUOTA;
+};
+
+const tokenQuotaOptions = [
+  { label: "不限制", value: UNLIMITED_TOKEN_QUOTA },
+  { label: "$10", value: usdToRawBilling(10) },
+  { label: "$20", value: usdToRawBilling(20) },
+  { label: "$50", value: usdToRawBilling(50) },
+  { label: "$100", value: usdToRawBilling(100) },
+] as const;
 
 const formatAvailableQuota = (value: number): string => {
-  const usdValue = Math.max(0, Math.floor(rawBillingToUsd(value)))
-  return `$${usdValue}`
-}
+  if (isUnlimitedTokenQuota(value)) {
+    return "无限";
+  }
 
-export function Tokens({
-  createMode = false,
-  editRoute = false,
-}: {
-  createMode?: boolean
-  editRoute?: boolean
-}) {
-  const navigate = useNavigate()
-  const { key: routeKey } = useParams<{ key: string }>()
-  const isRouteEdit = editRoute && Boolean(routeKey)
-  const [view, setView] = useState<'list' | 'form'>((createMode || isRouteEdit) ? 'form' : 'list')
-  const [editMode, setEditMode] = useState<EditMode>('form')
-  const [editingKey, setEditingKey] = useState<string | null>(null)
+  const usdValue = Math.max(0, Math.floor(rawBillingToUsd(value)));
+  return `$${usdValue}`;
+};
+
+export function Tokens({ createMode = false, editRoute = false }: { createMode?: boolean; editRoute?: boolean }) {
+  const navigate = useNavigate();
+  const { key: routeKey } = useParams<{ key: string }>();
+  const isRouteEdit = editRoute && Boolean(routeKey);
+  const [view, setView] = useState<"list" | "form">(createMode || isRouteEdit ? "form" : "list");
+  const [editMode, setEditMode] = useState<EditMode>("form");
+  const [editingKey, setEditingKey] = useState<string | null>(null);
   const [formData, setFormData] = useState<TokenConfig>({
-    name: '',
+    name: "",
     channel_keys: [],
     total_quota: 0,
-  })
-  const [tokenKey, setTokenKey] = useState(() => (createMode ? generateTokenKey() : ''))
-  const [jsonValue, setJsonValue] = useState('')
-  const [availableChannels, setAvailableChannels] = useState<string[]>([])
-  const [selectedChannels, setSelectedChannels] = useState<string[]>([])
-  const [searchQuery, setSearchQuery] = useState('')
-  const [openMenu, setOpenMenu] = useState<string | null>(null)
-  const [quotaInputValue, setQuotaInputValue] = useState(formatQuotaInputValue(0))
+  });
+  const [tokenKey, setTokenKey] = useState(() => (createMode ? generateTokenKey() : ""));
+  const [jsonValue, setJsonValue] = useState("");
+  const [availableChannels, setAvailableChannels] = useState<string[]>([]);
+  const [selectedChannels, setSelectedChannels] = useState<string[]>([]);
+  const [searchQuery, setSearchQuery] = useState("");
+  const [openMenu, setOpenMenu] = useState<string | null>(null);
+  const [quotaInputValue, setQuotaInputValue] = useState(() => formatQuotaInputValue(0));
 
-  const { addToast } = useToast()
-  const queryClient = useQueryClient()
-  const { data: billingConfig } = useBillingConfig()
-  const displayDecimals = billingConfig?.displayDecimals ?? DEFAULT_BILLING_DISPLAY_DECIMALS
+  const { addToast } = useToast();
+  const queryClient = useQueryClient();
+  const { data: billingConfig } = useBillingConfig();
+  const displayDecimals = billingConfig?.displayDecimals ?? DEFAULT_BILLING_DISPLAY_DECIMALS;
 
   const { data, isLoading, isFetching, refetch } = useQuery({
-    queryKey: ['tokens'],
+    queryKey: ["tokens"],
     queryFn: async () => {
-      const response = await apiClient.getTokens()
-      return response.data as Token[]
+      const response = await apiClient.getTokens();
+      return response.data as Token[];
     },
-  })
+  });
 
   useEffect(() => {
     const loadChannels = async () => {
       try {
-        const response = await apiClient.getChannels()
-        const channels = response.data as Channel[]
-        setAvailableChannels(channels.map((c) => c.key))
+        const response = await apiClient.getChannels();
+        const channels = response.data as Channel[];
+        setAvailableChannels(channels.map((c) => c.key));
       } catch (error) {
-        console.error('Failed to load channels:', error)
+        console.error("Failed to load channels:", error);
       }
-    }
-    loadChannels()
-  }, [])
+    };
+    loadChannels();
+  }, []);
 
   const openTokenForEdit = useCallback((token: Token) => {
-    setEditingKey(token.key)
-    setTokenKey(token.key)
-    const config = typeof token.value === 'string' ? JSON.parse(token.value) : token.value
-    setFormData(config)
-    setJsonValue(JSON.stringify(config, null, 2))
-    setSelectedChannels(config.channel_keys || [])
-    setQuotaInputValue(formatQuotaInputValue(config.total_quota || 0))
-    setView('form')
-  }, [])
+    setEditingKey(token.key);
+    setTokenKey(token.key);
+    const config = typeof token.value === "string" ? JSON.parse(token.value) : token.value;
+    const normalizedConfig = {
+      ...config,
+      channel_keys: config.channel_keys || [],
+      total_quota: normalizeTokenQuota(config.total_quota),
+    };
+    setFormData(normalizedConfig);
+    setJsonValue(JSON.stringify(normalizedConfig, null, 2));
+    setSelectedChannels(normalizedConfig.channel_keys);
+    setQuotaInputValue(formatQuotaInputValue(normalizedConfig.total_quota));
+    setView("form");
+  }, []);
 
   // Close menu when clicking outside
   useEffect(() => {
-    const handleClick = () => setOpenMenu(null)
-    document.addEventListener('click', handleClick)
-    return () => document.removeEventListener('click', handleClick)
-  }, [])
+    const handleClick = () => setOpenMenu(null);
+    document.addEventListener("click", handleClick);
+    return () => document.removeEventListener("click", handleClick);
+  }, []);
 
   const saveMutation = useMutation({
     mutationFn: async ({ key, config }: { key: string; config: any }) => {
-      return apiClient.saveToken(key, config)
+      return apiClient.saveToken(key, config);
     },
     onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ['tokens'] })
-      addToast(editingKey ? '令牌更新成功' : '令牌添加成功', 'success')
-      closeForm()
+      queryClient.invalidateQueries({ queryKey: ["tokens"] });
+      addToast(editingKey ? "令牌更新成功" : "令牌添加成功", "success");
+      closeForm();
     },
     onError: (error: any) => {
-      addToast('保存失败：' + error.message, 'error')
+      addToast("保存失败：" + error.message, "error");
     },
-  })
+  });
 
   const deleteMutation = useMutation({
     mutationFn: async (key: string) => {
-      return apiClient.deleteToken(key)
+      return apiClient.deleteToken(key);
     },
     onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ['tokens'] })
-      addToast('令牌已删除', 'success')
+      queryClient.invalidateQueries({ queryKey: ["tokens"] });
+      addToast("令牌已删除", "success");
     },
     onError: (error: any) => {
-      addToast('删除失败：' + error.message, 'error')
+      addToast("删除失败：" + error.message, "error");
     },
-  })
+  });
 
   const resetUsageMutation = useMutation({
     mutationFn: async (key: string) => {
-      return apiClient.resetTokenUsage(key)
+      return apiClient.resetTokenUsage(key);
     },
     onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ['tokens'] })
-      addToast('已用额度已重置', 'success')
+      queryClient.invalidateQueries({ queryKey: ["tokens"] });
+      addToast("已用额度已重置", "success");
     },
     onError: (error: any) => {
-      addToast('重置失败：' + error.message, 'error')
+      addToast("重置失败：" + error.message, "error");
     },
-  })
+  });
 
   const resetForm = useCallback(() => {
-    setFormData({ name: '', channel_keys: [], total_quota: 0 })
-    setTokenKey('')
-    setJsonValue('')
-    setSelectedChannels([])
-    setEditingKey(null)
-    setEditMode('form')
-    setQuotaInputValue(formatQuotaInputValue(0))
-  }, [])
+    setFormData({ name: "", channel_keys: [], total_quota: 0 });
+    setTokenKey("");
+    setJsonValue("");
+    setSelectedChannels([]);
+    setEditingKey(null);
+    setEditMode("form");
+    setQuotaInputValue(formatQuotaInputValue(0));
+  }, []);
 
   useEffect(() => {
     if (createMode) {
-      resetForm()
-      setTokenKey(generateTokenKey())
-      setView('form')
-      return
+      resetForm();
+      setTokenKey(generateTokenKey());
+      setView("form");
+      return;
     }
 
     if (isRouteEdit) {
       if (isLoading) {
-        setView('form')
-        return
+        setView("form");
+        return;
       }
 
-      const targetToken = data?.find((token) => token.key === routeKey)
+      const targetToken = data?.find((token) => token.key === routeKey);
       if (!targetToken) {
-        resetForm()
-        setView('list')
-        addToast('未找到对应令牌', 'error')
-        navigate('/tokens', { replace: true })
-        return
+        resetForm();
+        setView("list");
+        addToast("未找到对应令牌", "error");
+        navigate("/tokens", { replace: true });
+        return;
       }
 
-      openTokenForEdit(targetToken)
-      return
+      openTokenForEdit(targetToken);
+      return;
     }
 
-    resetForm()
-    setView('list')
-  }, [addToast, createMode, data, isLoading, isRouteEdit, navigate, openTokenForEdit, resetForm, routeKey])
+    resetForm();
+    setView("list");
+  }, [addToast, createMode, data, isLoading, isRouteEdit, navigate, openTokenForEdit, resetForm, routeKey]);
 
   const closeForm = () => {
-    resetForm()
-    setView('list')
+    resetForm();
+    setView("list");
 
     if (createMode || isRouteEdit) {
-      navigate('/tokens', { replace: true })
+      navigate("/tokens", { replace: true });
     }
-  }
+  };
 
   const handleAdd = () => {
-    resetForm()
-    navigate('/tokens/new')
-  }
+    resetForm();
+    navigate("/tokens/new");
+  };
 
   const handleEdit = (token: Token) => {
-    navigate(`/tokens/edit/${encodeURIComponent(token.key)}`)
-  }
+    navigate(`/tokens/edit/${encodeURIComponent(token.key)}`);
+  };
 
   const handleDelete = (key: string) => {
     if (confirm(`确定要删除此令牌吗？`)) {
-      deleteMutation.mutate(key)
+      deleteMutation.mutate(key);
     }
-  }
+  };
 
   const handleResetUsage = (key: string) => {
     if (confirm(`确定要重置此令牌的已用额度吗？`)) {
-      resetUsageMutation.mutate(key)
+      resetUsageMutation.mutate(key);
     }
-  }
+  };
 
   const handleCopy = async (text: string) => {
     try {
-      await copyToClipboard(text)
-      addToast('已复制到剪贴板', 'success')
+      await copyToClipboard(text);
+      addToast("已复制到剪贴板", "success");
     } catch {
-      addToast('复制失败', 'error')
+      addToast("复制失败", "error");
     }
-  }
+  };
 
   const handleSave = () => {
     if (!tokenKey) {
-      addToast('请填写令牌标识', 'error')
-      return
+      addToast("请填写令牌标识", "error");
+      return;
     }
 
-    let config: any
-    if (editMode === 'form') {
+    let config: any;
+    if (editMode === "form") {
       if (!formData.name) {
-        addToast('请填写令牌名称', 'error')
-        return
+        addToast("请填写令牌名称", "error");
+        return;
       }
-      config = { ...formData, channel_keys: selectedChannels }
+      config = {
+        ...formData,
+        channel_keys: selectedChannels,
+        total_quota: normalizeTokenQuota(formData.total_quota),
+      };
     } else {
       try {
-        config = JSON.parse(jsonValue)
-        config.total_quota = Math.max(0, Math.round(config.total_quota || 0))
+        config = JSON.parse(jsonValue);
+        config.total_quota = normalizeTokenQuota(config.total_quota);
       } catch {
-        addToast('JSON格式错误', 'error')
-        return
+        addToast("JSON格式错误", "error");
+        return;
       }
     }
 
-    saveMutation.mutate({ key: tokenKey, config })
-  }
+    saveMutation.mutate({ key: tokenKey, config });
+  };
 
   const toggleEditMode = () => {
-    if (editMode === 'form') {
-      const config = { ...formData, channel_keys: selectedChannels }
-      setJsonValue(JSON.stringify(config, null, 2))
-      setEditMode('json')
+    if (editMode === "form") {
+      const config = {
+        ...formData,
+        channel_keys: selectedChannels,
+        total_quota: normalizeTokenQuota(formData.total_quota),
+      };
+      setJsonValue(JSON.stringify(config, null, 2));
+      setEditMode("json");
     } else {
       try {
-        const config = JSON.parse(jsonValue)
+        const config = JSON.parse(jsonValue);
         const normalizedConfig = {
           ...config,
-          total_quota: Math.max(0, Math.round(config.total_quota || 0)),
-        }
-        setFormData(normalizedConfig)
-        setSelectedChannels(normalizedConfig.channel_keys || [])
-        setQuotaInputValue(formatQuotaInputValue(normalizedConfig.total_quota || 0))
-        setEditMode('form')
+          total_quota: normalizeTokenQuota(config.total_quota),
+        };
+        setFormData(normalizedConfig);
+        setSelectedChannels(normalizedConfig.channel_keys || []);
+        setQuotaInputValue(formatQuotaInputValue(normalizedConfig.total_quota));
+        setEditMode("form");
       } catch {
-        addToast('JSON格式错误', 'error')
+        addToast("JSON格式错误", "error");
       }
     }
-  }
+  };
 
   const toggleChannel = (channelKey: string) => {
     setSelectedChannels((prev) =>
-      prev.includes(channelKey) ? prev.filter((k) => k !== channelKey) : [...prev, channelKey]
-    )
-  }
-
-  const quotaPresets = [
-    { label: '$1', value: usdToRawBilling(1) },
-    { label: '$5', value: usdToRawBilling(5) },
-    { label: '$10', value: usdToRawBilling(10) },
-    { label: '$20', value: usdToRawBilling(20) },
-    { label: '$50', value: usdToRawBilling(50) },
-    { label: '$100', value: usdToRawBilling(100) },
-  ]
+      prev.includes(channelKey) ? prev.filter((k) => k !== channelKey) : [...prev, channelKey],
+    );
+  };
 
   const filteredData = data?.filter((token) => {
-    if (!searchQuery) return true
-    const config = typeof token.value === 'string' ? JSON.parse(token.value) : token.value
+    if (!searchQuery) return true;
+    const config = typeof token.value === "string" ? JSON.parse(token.value) : token.value;
     return (
       config.name?.toLowerCase().includes(searchQuery.toLowerCase()) ||
       token.key.toLowerCase().includes(searchQuery.toLowerCase())
-    )
-  })
+    );
+  });
 
   // List View
-  if (view === 'list') {
+  if (view === "list") {
     return (
       <PageContainer
         title="令牌管理"
@@ -371,20 +417,24 @@ export function Tokens({
           <Card>
             <div className="divide-y">
               {filteredData?.map((token) => {
-                const config = typeof token.value === 'string' ? JSON.parse(token.value) : token.value
-                const channelKeys = config.channel_keys || []
-                const usedQuota = token.usage || 0
-                const availableQuota = Math.max((config.total_quota || 0) - usedQuota, 0)
-                const usagePercent = config.total_quota > 0
-                  ? Math.min(100, (usedQuota / config.total_quota) * 100)
-                  : 0
-                const isMenuOpen = openMenu === token.key
+                const config = typeof token.value === "string" ? JSON.parse(token.value) : token.value;
+                const channelKeys = config.channel_keys || [];
+                const usedQuota = token.usage || 0;
+                const totalQuota = normalizeTokenQuota(config.total_quota);
+                const availableQuota = isUnlimitedTokenQuota(totalQuota)
+                  ? UNLIMITED_TOKEN_QUOTA
+                  : Math.max(totalQuota - usedQuota, 0);
+                const usagePercent = isUnlimitedTokenQuota(totalQuota)
+                  ? 0
+                  : totalQuota > 0
+                    ? Math.min(100, (usedQuota / totalQuota) * 100)
+                    : usedQuota > 0
+                      ? 100
+                      : 0;
+                const isMenuOpen = openMenu === token.key;
 
                 return (
-                  <div
-                    key={token.key}
-                    className="p-4 hover:bg-muted/30 transition-colors"
-                  >
+                  <div key={token.key} className="p-4 hover:bg-muted/30 transition-colors">
                     {/* Mobile Layout */}
                     <div className="md:hidden space-y-3">
                       <div className="flex items-start justify-between">
@@ -404,8 +454,8 @@ export function Tokens({
                             size="icon"
                             className="h-8 w-8"
                             onClick={(e) => {
-                              e.stopPropagation()
-                              setOpenMenu(isMenuOpen ? null : token.key)
+                              e.stopPropagation();
+                              setOpenMenu(isMenuOpen ? null : token.key);
                             }}
                           >
                             <MoreHorizontal className="h-4 w-4" />
@@ -439,17 +489,23 @@ export function Tokens({
                       </div>
                       <div className="flex items-center gap-4 text-sm">
                         <span className="text-muted-foreground">
-                          渠道: <span className="text-foreground">{channelKeys.length === 0 ? '全部' : `${channelKeys.length}个`}</span>
+                          渠道:{" "}
+                          <span className="text-foreground">
+                            {channelKeys.length === 0 ? "全部" : `${channelKeys.length}个`}
+                          </span>
                         </span>
                         <span className="text-muted-foreground">
-                          已用/可用: <span className="text-foreground">{formatCurrency(usedQuota, displayDecimals)}/{formatAvailableQuota(availableQuota)}</span>
+                          已用/可用:{" "}
+                          <span className="text-foreground">
+                            {formatCurrency(usedQuota, displayDecimals)}/{formatAvailableQuota(availableQuota)}
+                          </span>
                         </span>
                       </div>
                       <div className="h-1.5 bg-muted rounded-full overflow-hidden">
                         <div
                           className={cn(
                             "h-full rounded-full transition-all",
-                            usagePercent > 90 ? "bg-destructive" : usagePercent > 70 ? "bg-warning" : "bg-primary"
+                            usagePercent > 90 ? "bg-destructive" : usagePercent > 70 ? "bg-warning" : "bg-primary",
                           )}
                           style={{ width: `${usagePercent}%` }}
                         />
@@ -471,18 +527,24 @@ export function Tokens({
                       </div>
                       <div className="w-24 text-sm text-center flex-shrink-0">
                         <span className="px-2 py-1 rounded-md bg-muted text-muted-foreground">
-                          {channelKeys.length === 0 ? '全部' : `${channelKeys.length} 渠道`}
+                          {channelKeys.length === 0 ? "全部" : `${channelKeys.length} 渠道`}
                         </span>
                       </div>
                       <div className="w-48 flex-shrink-0">
                         <div className="flex items-center justify-between text-xs mb-1">
                           <span className="text-muted-foreground">
-                            已用 {formatCurrency(usedQuota, displayDecimals)} / 可用 {formatAvailableQuota(availableQuota)}
+                            {formatCurrency(usedQuota, displayDecimals)} / {formatAvailableQuota(availableQuota)}
                           </span>
-                          <span className={cn(
-                            "font-medium",
-                            usagePercent > 90 ? "text-destructive" : usagePercent > 70 ? "text-warning" : "text-muted-foreground"
-                          )}>
+                          <span
+                            className={cn(
+                              "font-medium",
+                              usagePercent > 90
+                                ? "text-destructive"
+                                : usagePercent > 70
+                                  ? "text-warning"
+                                  : "text-muted-foreground",
+                            )}
+                          >
                             {usagePercent.toFixed(0)}%
                           </span>
                         </div>
@@ -490,37 +552,53 @@ export function Tokens({
                           <div
                             className={cn(
                               "h-full rounded-full transition-all",
-                              usagePercent > 90 ? "bg-destructive" : usagePercent > 70 ? "bg-warning" : "bg-primary"
+                              usagePercent > 90 ? "bg-destructive" : usagePercent > 70 ? "bg-warning" : "bg-primary",
                             )}
                             style={{ width: `${usagePercent}%` }}
                           />
                         </div>
                       </div>
                       <div className="flex items-center gap-1 flex-shrink-0">
-                        <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => handleEdit(token)} title="编辑">
+                        <Button
+                          variant="ghost"
+                          size="icon"
+                          className="h-8 w-8"
+                          onClick={() => handleEdit(token)}
+                          title="编辑"
+                        >
                           <Pencil className="h-4 w-4" />
                         </Button>
-                        <Button variant="ghost" size="icon" className="h-8 w-8" onClick={() => handleResetUsage(token.key)} title="重置额度">
+                        <Button
+                          variant="ghost"
+                          size="icon"
+                          className="h-8 w-8"
+                          onClick={() => handleResetUsage(token.key)}
+                          title="重置额度"
+                        >
                           <RotateCcw className="h-4 w-4" />
                         </Button>
-                        <Button variant="ghost" size="icon" className="h-8 w-8 text-destructive hover:text-destructive" onClick={() => handleDelete(token.key)} title="删除">
+                        <Button
+                          variant="ghost"
+                          size="icon"
+                          className="h-8 w-8 text-destructive hover:text-destructive"
+                          onClick={() => handleDelete(token.key)}
+                          title="删除"
+                        >
                           <Trash2 className="h-4 w-4" />
                         </Button>
                       </div>
                     </div>
                   </div>
-                )
+                );
               })}
               {filteredData?.length === 0 && searchQuery && (
-                <div className="p-8 text-center text-muted-foreground">
-                  未找到匹配的令牌
-                </div>
+                <div className="p-8 text-center text-muted-foreground">未找到匹配的令牌</div>
               )}
             </div>
           </Card>
         )}
       </PageContainer>
-    )
+    );
   }
 
   if (isRouteEdit && isLoading && !editingKey) {
@@ -533,7 +611,7 @@ export function Tokens({
           </div>
         </div>
       </div>
-    )
+    );
   }
 
   // Form View
@@ -547,181 +625,190 @@ export function Tokens({
             返回列表
           </Button>
           <div className="flex items-center justify-between">
-            <h1 className="text-2xl font-bold tracking-tight">{editingKey ? '编辑令牌' : '添加令牌'}</h1>
+            <h1 className="text-2xl font-bold tracking-tight">{editingKey ? "编辑令牌" : "添加令牌"}</h1>
             <Button variant="outline" size="sm" onClick={toggleEditMode}>
-              {editMode === 'form' ? <FileJson className="h-4 w-4 mr-1" /> : <FileText className="h-4 w-4 mr-1" />}
-              {editMode === 'form' ? 'JSON' : '表单'}
+              {editMode === "form" ? <FileJson className="h-4 w-4 mr-1" /> : <FileText className="h-4 w-4 mr-1" />}
+              {editMode === "form" ? "JSON" : "表单"}
             </Button>
           </div>
         </div>
 
         <div className="space-y-6">
-        {/* Token Key Section */}
-        <Card>
-          <CardContent className="p-5">
-            <h3 className="font-medium mb-1">令牌标识</h3>
-            <p className="text-sm text-muted-foreground mb-3">用于 API 认证的唯一标识</p>
-            <div className="flex gap-2">
-              <Input
-                value={tokenKey}
-                onChange={(e) => setTokenKey(e.target.value)}
-                placeholder="sk-xxxxxxxxxxxxxxxx"
-                disabled={!!editingKey}
-                className="font-mono text-sm"
-              />
-              {!editingKey && (
-                <Button type="button" variant="outline" onClick={() => setTokenKey(generateTokenKey())}>
-                  <Sparkles className="h-4 w-4" />
-                </Button>
-              )}
-            </div>
-          </CardContent>
-        </Card>
-
-        {editMode === 'form' ? (
-          <>
-            {/* Basic Info */}
-            <Card>
-              <CardContent className="p-5">
-                <h3 className="font-medium mb-4">基本信息</h3>
-                <div className="space-y-4">
-                  <div className="space-y-2">
-                    <Label className="text-sm">令牌名称 <span className="text-destructive">*</span></Label>
-                    <Input
-                      value={formData.name}
-                      onChange={(e) => setFormData({ ...formData, name: e.target.value })}
-                      placeholder="例如：生产环境、测试用户"
-                    />
-                  </div>
-                </div>
-              </CardContent>
-            </Card>
-
-            {/* Channel Access */}
-            <Card>
-              <CardContent className="p-5">
-                <div className="flex items-center justify-between mb-4">
-                  <div>
-                    <h3 className="font-medium">渠道访问权限</h3>
-                    <p className="text-sm text-muted-foreground">
-                      {selectedChannels.length === 0 ? '允许访问所有渠道' : `已选择 ${selectedChannels.length} 个渠道`}
-                    </p>
-                  </div>
-                </div>
-                {availableChannels.length === 0 ? (
-                  <div className="flex items-center gap-3 p-4 bg-muted/50 rounded-lg">
-                    <AlertCircle className="h-5 w-5 text-muted-foreground" />
-                    <div>
-                      <p className="text-sm font-medium">暂无可用渠道</p>
-                      <p className="text-xs text-muted-foreground">请先在渠道管理中添加渠道</p>
-                    </div>
-                  </div>
-                ) : (
-                  <div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
-                    {availableChannels.map((channelKey) => (
-                      <label
-                        key={channelKey}
-                        className={cn(
-                          "flex items-center gap-3 p-3 rounded-lg border cursor-pointer transition-colors",
-                          selectedChannels.includes(channelKey)
-                            ? "border-primary bg-primary/5"
-                            : "border-transparent bg-muted/50 hover:bg-muted"
-                        )}
-                      >
-                        <Checkbox
-                          checked={selectedChannels.includes(channelKey)}
-                          onCheckedChange={() => toggleChannel(channelKey)}
-                        />
-                        <span className="text-sm font-medium">{channelKey}</span>
-                      </label>
-                    ))}
-                  </div>
-                )}
-              </CardContent>
-            </Card>
-
-            {/* Quota */}
-            <Card>
-              <CardContent className="p-5">
-                <h3 className="font-medium mb-1">可用额度</h3>
-                <p className="text-sm text-muted-foreground mb-4">
-                  令牌可用的总额度，单位为美元，当已用额度达到总额度时，令牌将无法调用模型。
-                </p>
-                <div className="space-y-4">
-                  <Input
-                    type="text"
-                    inputMode="numeric"
-                    value={quotaInputValue}
-                    onChange={(e) => {
-                      const nextValue = e.target.value
-                      if (!INTEGER_QUOTA_PATTERN.test(nextValue)) {
-                        return
-                      }
-                      setQuotaInputValue(nextValue)
-                      setFormData({ ...formData, total_quota: parseQuotaInputValue(nextValue) })
-                    }}
-                    placeholder="1"
-                  />
-                  <div className="flex flex-wrap gap-2">
-                    {quotaPresets.map((preset) => (
-                      <button
-                        key={preset.value}
-                        type="button"
-                        onClick={() => {
-                          setFormData({ ...formData, total_quota: preset.value })
-                          setQuotaInputValue(formatQuotaInputValue(preset.value))
-                        }}
-                        className={cn(
-                          "px-4 py-2 rounded-lg text-sm font-medium transition-all",
-                          formData.total_quota === preset.value
-                            ? "bg-primary text-primary-foreground shadow-sm"
-                            : "bg-muted hover:bg-muted/80"
-                        )}
-                      >
-                        {preset.label}
-                      </button>
-                    ))}
-                  </div>
-                </div>
-              </CardContent>
-            </Card>
-          </>
-        ) : (
+          {/* Token Key Section */}
           <Card>
             <CardContent className="p-5">
-              <h3 className="font-medium mb-4">JSON 配置</h3>
-              <Textarea
-                value={jsonValue}
-                onChange={(e) => setJsonValue(e.target.value)}
-                rows={14}
-                className="font-mono text-sm"
-                placeholder='{"name": "令牌名称", "channel_keys": [], "total_quota": 1000000000}'
-              />
+              <h3 className="font-medium mb-1">令牌标识</h3>
+              <p className="text-sm text-muted-foreground mb-3">用于 API 认证的唯一标识</p>
+              <div className="flex gap-2">
+                <Input
+                  value={tokenKey}
+                  onChange={(e) => setTokenKey(e.target.value)}
+                  placeholder="sk-xxxxxxxxxxxxxxxx"
+                  disabled={!!editingKey}
+                  className="font-mono text-sm"
+                />
+                {!editingKey && (
+                  <Button type="button" variant="outline" onClick={() => setTokenKey(generateTokenKey())}>
+                    <Sparkles className="h-4 w-4" />
+                  </Button>
+                )}
+              </div>
             </CardContent>
           </Card>
-        )}
 
-        {/* Actions */}
-        <div className="flex items-center justify-end gap-3 pt-2">
-          <Button variant="outline" onClick={closeForm}>
-            取消
-          </Button>
-          <Button onClick={handleSave} disabled={saveMutation.isPending}>
-            {saveMutation.isPending ? (
-              <>
-                <RefreshCw className="h-4 w-4 mr-2 animate-spin" />
-                保存中...
-              </>
-            ) : (
-              <>
-                <Check className="h-4 w-4 mr-2" />
-                保存令牌
-              </>
-            )}
-          </Button>
-        </div>
+          {editMode === "form" ? (
+            <>
+              {/* Basic Info */}
+              <Card>
+                <CardContent className="p-5">
+                  <h3 className="font-medium mb-4">基本信息</h3>
+                  <div className="space-y-4">
+                    <div className="space-y-2">
+                      <Label className="text-sm">
+                        令牌名称 <span className="text-destructive">*</span>
+                      </Label>
+                      <Input
+                        value={formData.name}
+                        onChange={(e) => setFormData({ ...formData, name: e.target.value })}
+                        placeholder="例如：生产环境、测试用户"
+                      />
+                    </div>
+                  </div>
+                </CardContent>
+              </Card>
+
+              {/* Channel Access */}
+              <Card>
+                <CardContent className="p-5">
+                  <div className="flex items-center justify-between mb-4">
+                    <div>
+                      <h3 className="font-medium">渠道访问权限</h3>
+                      <p className="text-sm text-muted-foreground">
+                        {selectedChannels.length === 0
+                          ? "允许访问所有渠道"
+                          : `已选择 ${selectedChannels.length} 个渠道`}
+                      </p>
+                    </div>
+                  </div>
+                  {availableChannels.length === 0 ? (
+                    <div className="flex items-center gap-3 p-4 bg-muted/50 rounded-lg">
+                      <AlertCircle className="h-5 w-5 text-muted-foreground" />
+                      <div>
+                        <p className="text-sm font-medium">暂无可用渠道</p>
+                        <p className="text-xs text-muted-foreground">请先在渠道管理中添加渠道</p>
+                      </div>
+                    </div>
+                  ) : (
+                    <div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
+                      {availableChannels.map((channelKey) => (
+                        <label
+                          key={channelKey}
+                          className={cn(
+                            "flex items-center gap-3 p-3 rounded-lg border cursor-pointer transition-colors",
+                            selectedChannels.includes(channelKey)
+                              ? "border-primary bg-primary/5"
+                              : "border-transparent bg-muted/50 hover:bg-muted",
+                          )}
+                        >
+                          <Checkbox
+                            checked={selectedChannels.includes(channelKey)}
+                            onCheckedChange={() => toggleChannel(channelKey)}
+                          />
+                          <span className="text-sm font-medium">{channelKey}</span>
+                        </label>
+                      ))}
+                    </div>
+                  )}
+                </CardContent>
+              </Card>
+
+              {/* Quota */}
+              <Card>
+                <CardContent className="p-5">
+                  <h3 className="font-medium mb-1">可用额度</h3>
+                  <p className="text-sm text-muted-foreground mb-4">额度耗尽后将不可调用付费模型。</p>
+                  <div className="space-y-4">
+                    <div className="grid grid-cols-1 sm:grid-cols-2 gap-4 items-center">
+                      <Input
+                        type="text"
+                        inputMode="numeric"
+                        value={quotaInputValue}
+                        onChange={(e) => {
+                          const nextValue = e.target.value;
+                          if (!QUOTA_INPUT_PATTERN.test(nextValue)) {
+                            return;
+                          }
+
+                          setQuotaInputValue(nextValue);
+
+                          if (nextValue === "-") {
+                            return;
+                          }
+
+                          const parsedQuota = parseQuotaInputValue(nextValue);
+                          if (parsedQuota === null) {
+                            return;
+                          }
+
+                          setFormData({ ...formData, total_quota: parsedQuota });
+                        }}
+                        onBlur={() => {
+                          setQuotaInputValue(formatQuotaInputValue(normalizeTokenQuota(formData.total_quota)));
+                        }}
+                        placeholder="输入美元额度，0 表示无额度，-1 表示无限"
+                      />
+                      <ButtonGroup
+                        aria-label="令牌可用额度"
+                        value={normalizeTokenQuota(formData.total_quota)}
+                        options={tokenQuotaOptions}
+                        onValueChange={(value) => {
+                          setFormData({ ...formData, total_quota: value });
+                          setQuotaInputValue(formatQuotaInputValue(value));
+                        }}
+                        className="h-10 items-center flex-nowrap"
+                        buttonClassName="h-full w-full text-sm data-[state=on]:bg-green-100! data-[state=on]:text-white"
+                      />
+                    </div>
+                  </div>
+                </CardContent>
+              </Card>
+            </>
+          ) : (
+            <Card>
+              <CardContent className="p-5">
+                <h3 className="font-medium mb-4">JSON 配置</h3>
+                <Textarea
+                  value={jsonValue}
+                  onChange={(e) => setJsonValue(e.target.value)}
+                  rows={14}
+                  className="font-mono text-sm"
+                  placeholder='{"name": "令牌名称", "channel_keys": [], "total_quota": -1}'
+                />
+              </CardContent>
+            </Card>
+          )}
+
+          {/* Actions */}
+          <div className="flex items-center justify-end gap-3 pt-2">
+            <Button variant="outline" onClick={closeForm}>
+              取消
+            </Button>
+            <Button onClick={handleSave} disabled={saveMutation.isPending}>
+              {saveMutation.isPending ? (
+                <>
+                  <RefreshCw className="h-4 w-4 mr-2 animate-spin" />
+                  保存中...
+                </>
+              ) : (
+                <>
+                  <Check className="h-4 w-4 mr-2" />
+                  保存令牌
+                </>
+              )}
+            </Button>
+          </div>
         </div>
       </div>
     </div>
-  )
+  );
 }
diff --git a/frontend/src/types/index.ts b/frontend/src/types/index.ts
index a4a046d..0b19b99 100644
--- a/frontend/src/types/index.ts
+++ b/frontend/src/types/index.ts
@@ -35,7 +35,7 @@ export interface Token {
 export interface TokenConfig {
   name: string
   channel_keys?: string[]
-  total_quota: number
+  total_quota: number // 原始计费单位整数，-1 表示无限额度
 }
 
 export interface BillingConfig {
diff --git a/src/admin/token_api.ts b/src/admin/token_api.ts
index 0a593cf..db5973f 100644
--- a/src/admin/token_api.ts
+++ b/src/admin/token_api.ts
@@ -3,6 +3,7 @@ import { OpenAPIRoute } from 'chanfana';
 import { z } from 'zod';
 
 import { CommonErrorResponse, CommonSuccessfulResponse } from "../model";
+import { TokenUtils } from "./token_utils";
 
 // Token 列表 API
 export class TokenListEndpoint extends OpenAPIRoute {
@@ -48,7 +49,8 @@ export class TokenUpsertEndpoint extends OpenAPIRoute {
                         schema: z.object({
                             name: z.string().describe('Token name'),
                             channel_keys: z.array(z.string()).describe('Channel keys to bind (empty array means access to all channels)'),
-                            total_quota: z.number().int().nonnegative().describe('Total quota amount in raw billing units'),
+                            total_quota: z.union([z.literal(-1), z.number().int().nonnegative()])
+                                .describe('Total quota amount in raw billing units, -1 means unlimited'),
                         }),
                     },
                 },
@@ -62,18 +64,22 @@ export class TokenUpsertEndpoint extends OpenAPIRoute {
 
     async handle(c: Context<HonoCustomType>) {
         const body = await c.req.json<ApiTokenData>();
+        const normalizedBody: ApiTokenData = {
+            ...body,
+            total_quota: TokenUtils.normalizeQuota(body.total_quota),
+        };
         const { key } = c.req.param();
 
         // Validate channels exist using batch query (if channel_keys is not empty)
-        if (body.channel_keys && body.channel_keys.length > 0) {
-            const channelQuery = body.channel_keys.map(() => '?').join(',');
+        if (normalizedBody.channel_keys && normalizedBody.channel_keys.length > 0) {
+            const channelQuery = normalizedBody.channel_keys.map(() => '?').join(',');
             const existingChannels = await c.env.DB.prepare(
                 `SELECT key FROM channel_config WHERE key IN (${channelQuery})`
-            ).bind(...body.channel_keys).all();
+            ).bind(...normalizedBody.channel_keys).all();
 
-            if (!existingChannels.results || existingChannels.results.length !== body.channel_keys.length) {
+            if (!existingChannels.results || existingChannels.results.length !== normalizedBody.channel_keys.length) {
                 const existingKeys = existingChannels.results?.map((row: any) => row.key) || [];
-                const missingKeys = body.channel_keys.filter(key => !existingKeys.includes(key));
+                const missingKeys = normalizedBody.channel_keys.filter(key => !existingKeys.includes(key));
                 return c.text(`Channels not found: ${missingKeys.join(', ')}`, 400);
             }
         }
@@ -85,7 +91,7 @@ export class TokenUpsertEndpoint extends OpenAPIRoute {
              ON CONFLICT(key) DO UPDATE SET
              value = excluded.value,
              updated_at = datetime('now')`
-        ).bind(key, JSON.stringify(body)).run();
+        ).bind(key, JSON.stringify(normalizedBody)).run();
 
         if (!result.success) {
             return c.text('Failed to upsert token', 500);
diff --git a/src/admin/token_utils.ts b/src/admin/token_utils.ts
index 919e0ef..72da353 100644
--- a/src/admin/token_utils.ts
+++ b/src/admin/token_utils.ts
@@ -16,6 +16,8 @@ type UsageCostResult = {
     hasPricing: boolean;
 }
 
+const UNLIMITED_TOKEN_QUOTA = -1;
+
 const normalizeBillingMode = (value: unknown): PricingBillingMode | undefined => {
     if (value === "volume" || value === "request") {
         return value;
@@ -28,6 +30,54 @@ const calculateFixedCostRaw = (value: unknown): number => {
     return calculateRequestCostRaw(value || 0);
 };
 
+const normalizeTokenQuota = (value: unknown): number => {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        const normalizedValue = Math.round(value);
+        return normalizedValue === UNLIMITED_TOKEN_QUOTA
+            ? UNLIMITED_TOKEN_QUOTA
+            : Math.max(0, normalizedValue);
+    }
+
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return normalizeTokenQuota(parsed);
+        }
+    }
+
+    return 0;
+};
+
+const normalizeTokenUsage = (value: unknown): number => {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return Math.max(0, Math.round(value));
+    }
+
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return normalizeTokenUsage(parsed);
+        }
+    }
+
+    return 0;
+};
+
+const hasPositivePricingValue = (value: unknown): boolean => {
+    return typeof value === "number" && Number.isFinite(value) && value > 0;
+};
+
+const pricingRequiresQuota = (pricing: ModelPricing | null): boolean => {
+    if (!pricing) {
+        return false;
+    }
+
+    return hasPositivePricingValue(pricing.request)
+        || hasPositivePricingValue(pricing.input)
+        || hasPositivePricingValue(pricing.output)
+        || hasPositivePricingValue(pricing.cache);
+};
+
 // Token 工具对象
 export const TokenUtils = {
     async updateUsage(c: Context<HonoCustomType>, key: string, usageAmount: number): Promise<boolean> {
@@ -52,6 +102,24 @@ export const TokenUtils = {
         const globalPricingMap = await getJsonSetting(c, CONSTANTS.MODEL_PRICING_KEY);
         return globalPricingMap?.[model] || null;
     },
+    normalizeQuota(value: unknown): number {
+        return normalizeTokenQuota(value);
+    },
+    hasRemainingQuota(totalQuota: unknown, usage: unknown): boolean {
+        const normalizedTotalQuota = normalizeTokenQuota(totalQuota);
+        const normalizedUsage = normalizeTokenUsage(usage);
+
+        return normalizedTotalQuota === UNLIMITED_TOKEN_QUOTA
+            || normalizedUsage < normalizedTotalQuota;
+    },
+    async modelRequiresPaidQuota(
+        c: Context<HonoCustomType>,
+        model: string,
+        channelConfig: ChannelConfig
+    ): Promise<boolean> {
+        const pricing = await this.getPricing(c, model, channelConfig);
+        return pricingRequiresQuota(pricing);
+    },
 
     async calculateUsageCost(
         c: Context<HonoCustomType>,
diff --git a/src/providers/models.ts b/src/providers/models.ts
index 2fa88aa..136e665 100644
--- a/src/providers/models.ts
+++ b/src/providers/models.ts
@@ -4,6 +4,7 @@ import { z } from "zod";
 import { getApiKeyFromHeaders, fetchTokenData, fetchChannelsForToken } from "./shared/auth";
 import { getChannelModels } from "../utils";
 import { normalizeChannelConfig } from "../channel-config";
+import { TokenUtils } from "../admin/token_utils";
 
 export class ModelsEndpoint extends OpenAPIRoute {
     schema = {
@@ -56,6 +57,7 @@ export class ModelsEndpoint extends OpenAPIRoute {
         }
 
         const modelsSet = new Set<string>();
+        const hasRemainingQuota = TokenUtils.hasRemainingQuota(tokenInfo.tokenData.total_quota, tokenInfo.usage);
 
         for (const row of channelsResult.results) {
             const config = normalizeChannelConfig(JSON.parse(row.value) as ChannelConfig);
@@ -63,6 +65,9 @@ export class ModelsEndpoint extends OpenAPIRoute {
                 continue;
             }
             for (const model of getChannelModels(config)) {
+                if (!hasRemainingQuota && await TokenUtils.modelRequiresPaidQuota(c, model.name, config)) {
+                    continue;
+                }
                 modelsSet.add(model.name);
             }
         }
diff --git a/src/providers/shared/channel-resolver.ts b/src/providers/shared/channel-resolver.ts
index 4ee0f50..145224f 100644
--- a/src/providers/shared/channel-resolver.ts
+++ b/src/providers/shared/channel-resolver.ts
@@ -56,10 +56,6 @@ export const resolveChannel = async (
 
     const { tokenData, usage } = tokenInfo;
 
-    if (usage >= tokenData.total_quota) {
-        return c.text("Quota exceeded", 402);
-    }
-
     const channelsResult = await fetchChannelsForToken(c, tokenData);
 
     if (!channelsResult.results || channelsResult.results.length === 0) {
@@ -80,7 +76,7 @@ export const resolveChannel = async (
     const policy = getRoutePolicy(routeId);
     const allowedTypes = policy.allowedTypes;
 
-    const availableChannels: ResolvedChannelCandidate[] = [];
+    let availableChannels: ResolvedChannelCandidate[] = [];
     let hasDisabledMatchingChannel = false;
 
     for (const row of channelsResult.results) {
@@ -124,6 +120,23 @@ export const resolveChannel = async (
         return c.text(`Model not supported: ${requestedModel}. Please configure models.`, 400);
     }
 
+    if (!TokenUtils.hasRemainingQuota(tokenData.total_quota, usage)) {
+        const freeChannels = await Promise.all(
+            availableChannels.map(async (channel) => ({
+                channel,
+                requiresPaidQuota: await TokenUtils.modelRequiresPaidQuota(c, requestedModel, channel.config),
+            }))
+        );
+
+        availableChannels = freeChannels
+            .filter((item) => !item.requiresPaidQuota)
+            .map((item) => item.channel);
+
+        if (availableChannels.length === 0) {
+            return c.text("Quota exceeded for paid models", 402);
+        }
+    }
+
     const selectedChannel = pickHighestPriorityChannel(availableChannels);
     const trackingState: RequestTrackingState = {
         retryCount: 0,
diff --git a/type.d.ts b/type.d.ts
index 9f68fa6..d017482 100644
--- a/type.d.ts
+++ b/type.d.ts
@@ -144,7 +144,7 @@ type SystemConfig = BillingConfig & {
 type ApiTokenData = {
     name: string;
     channel_keys: string[];
-    total_quota: number; // 原始计费单位整数
+    total_quota: number; // 原始计费单位整数，-1 表示无限额度
 }
 
 type RequestTrackingState = {