价格表

价格表管理是 Claude Code Hub 成本核算的基础功能。系统通过价格表计算每次 API 请求的成本，帮助管理员准确追踪和控制团队的 AI 使用支出。本文将详细介绍价格表管理页面的各项功能。

页面概览

价格表管理页面位于 设置 > 价格表 (/settings/prices)，提供以下核心功能：

• 浏览和搜索模型价格信息
• 从 LiteLLM 一键同步最新价格
• 手动上传自定义价格表
• 分页浏览大量模型数据

价格列表

表格字段

价格列表以表格形式展示所有模型的定价信息：

模型类型

系统支持以下模型类型，通过不同颜色的标签区分：

搜索功能

页面顶部提供搜索框，支持按模型名称进行模糊搜索：

• 输入关键词后自动触发搜索（500ms 防抖）
• 搜索会重置到第一页
• 搜索词会同步到 URL 参数，方便分享和刷新

分页控制

对于大量模型数据，页面提供完整的分页功能：

• 每页条数：可选择 20、50、100、200 条/页（默认 50）
• 页码导航：显示当前页码和总页数，支持快速跳转
• 统计信息：底部显示总模型数量和当前显示范围

分页参数同样会同步到 URL，支持直接通过 URL 访问特定页面：

/settings/prices?page=2&size=100&search=claude

同步 LiteLLM 价格

功能说明

Claude Code Hub 支持从 LiteLLM 项目同步最新的模型价格数据。LiteLLM 维护了一份完整的 AI 模型价格表，涵盖 Claude、GPT、Gemini 等主流模型。

同步流程

点击页面右上角的「同步 LiteLLM」按钮即可开始同步：

1. 系统从 CDN 获取 LiteLLM 最新价格表
2. 如果 CDN 获取失败，自动降级使用本地缓存
3. 解析并处理价格数据
4. 与现有数据对比，识别新增、更新、未变化的模型
5. 将变更写入数据库
6. 刷新页面显示最新数据

同步结果

同步完成后会显示详细结果：

上传价格表

适用场景

在以下情况下，您可能需要手动上传价格表：

• 网络环境无法访问 LiteLLM CDN
• 需要使用自定义的模型定价
• 需要添加 LiteLLM 未收录的模型

文件格式

上传的 JSON 文件需要符合 LiteLLM 价格表格式：

{
  "claude-3-5-sonnet-20241022": {
    "mode": "chat",
    "input_cost_per_token": 0.000003,
    "output_cost_per_token": 0.000015,
    "max_tokens": 8192,
    "litellm_provider": "anthropic"
  },
  "gpt-4o": {
    "mode": "chat",
    "input_cost_per_token": 0.000005,
    "output_cost_per_token": 0.000015,
    "max_tokens": 4096,
    "litellm_provider": "openai"
  }
}

上传流程

1. 点击「更新价格表」按钮打开上传对话框
2. 选择符合格式的 JSON 文件（最大 10MB）
3. 系统自动验证文件格式并处理数据
4. 显示处理结果（新增、更新、跳过、失败的模型数量）
5. 点击「完成」关闭对话框，页面自动刷新

处理结果

上传完成后会显示详细的处理报告：

• 总数：文件中包含的模型总数
• 新增成功：成功添加的新模型（绿色）
• 更新成功：成功更新价格的模型（蓝色）
• 已跳过：价格未变化的模型（灰色）
• 处理失败：格式错误或处理异常的模型（红色）

自动初始化

种子数据

系统首次启动时，如果数据库中没有价格数据，会自动从内置的种子文件初始化价格表。种子文件位于 public/seed/litellm-prices.json。

初始化时机

自动初始化在以下条件满足时触发：

1. 数据库中不存在任何价格记录
2. 种子文件存在且格式正确

价格计算说明

Token 价格

价格表中的价格以「每 Token」为单位存储，界面显示时自动转换为「每百万 Token」（$/M）格式，便于阅读。

转换公式：显示价格 = 存储价格 × 1,000,000

成本计算

每次请求的成本按以下公式计算：

请求成本 = 输入 Token × 输入价格 + 输出 Token × 输出价格

如果使用了供应商的成本系数（cost multiplier），最终成本会乘以该系数：

最终成本 = 请求成本 × 供应商成本系数

图像生成模型

对于图像生成模型，计费方式不同：

• 不使用 Token 计费
• 使用「每张图片」价格
• 界面显示为 $X.XX/img

权限说明

价格表管理功能仅对管理员开放：

最佳实践

定期同步

建议定期同步 LiteLLM 价格表（如每月一次），确保价格数据与供应商的最新定价保持一致。

备份价格数据

在进行大规模更新前，建议通过「数据管理」功能导出当前配置作为备份。

自定义价格

如果您的供应商提供了特殊定价（如企业折扣），可以：

1. 先同步 LiteLLM 获取基准价格
2. 通过上传自定义价格表覆盖特定模型的价格
3. 或使用供应商的「成本系数」功能全局调整

相关功能

• 设置概览 - 了解所有设置模块
• 供应商管理 - 配置供应商的成本系数
• 排行榜 - 查看基于成本计算的用户排行
• 日志查询 - 查看包含成本信息的请求日志