OneHub 价格同步使用指南

详细的部署和使用说明文档

← 返回价格查询主页

项目简介

本项目管理多个 AI 供应商的价格信息,支持自动获取和手动维护多种来源的价格数据。包含以下价格表:

  • oneapi_prices.json: 适用于 one-hub 的完整价格表,包含所有供应商
  • onehub_only_prices.json: 仅包含供应商 id ≤ 1000 的核心供应商价格表
  • siliconflow_prices.json: 来自 siliconflow 官方的原始价格数据
  • openrouter_prices.json: 来自 openrouter 官方的原始价格数据

所有价格数据每 6 小时自动更新,确保信息及时准确。

主要文件说明

⚠️ 重要提示

  • 价格表与供应商 JSON 结果均已迁移至 prices 分支,使用前请注意更新 url 路径
  • 使用任何价格表前,请务必检查 ownedby.json 以确保供应商 ID 与本项目版本一致
  • 如需使用除了 onehub 默认定义的供应商之外的价格,请确保你的模型归属页面与 ownedby.json 中的定义一致

价格表选择

1. 完整价格表 (oneapi_prices.json)

包含所有供应商的价格信息,适用于需要完整价格数据的场景

地址:

  • GitHub Raw: https://raw.githubusercontent.com/Oaklight/onehub_prices/prices/oneapi_prices.json
  • jsDelivr CDN: https://cdn.jsdelivr.net/gh/Oaklight/onehub_prices@prices/oneapi_prices.json
  • jsDelivr Mirror: https://cdn.jsdmirror.com/gh/Oaklight/onehub_prices@prices/oneapi_prices.json

2. 核心供应商价格表 (onehub_only_prices.json)

仅包含供应商 id ≤ 1000 的核心供应商,适用于只需要核心供应商价格的场景

地址:

  • GitHub Raw: https://raw.githubusercontent.com/Oaklight/onehub_prices/prices/onehub_only_prices.json
  • jsDelivr CDN: https://cdn.jsdelivr.net/gh/Oaklight/onehub_prices@prices/onehub_only_prices.json
  • jsDelivr Mirror: https://cdn.jsdmirror.com/npm/onehub_prices@prices/onehub_only_prices.json

价格同步指导

方法一:通过 OneHub 运营界面更新

核对模型归属:

  1. 进入 运营 → 模型归属
  2. 对比 ownedby.json 文件,手工增删查改模型归属信息

更新模型价格:

  1. 进入 运营 → 模型价格 → 更新价格
  2. 根据需求选择上述价格表地址填入
  3. 点击 获取数据
  4. 按需选择 覆盖数据仅添加新增

方法二:通过 OneHub API 脚本更新(推荐)

使用步骤:

  1. 确保已安装依赖项:
    pip install -r requirements.txt
  2. 运行脚本以同步 ownedby 数据:
    python src/sync_ownedby.py [--source_json SOURCE_JSON] [--source_url SOURCE_URL] [--manual_json MANUAL_JSON] [--manual_url MANUAL_URL]

    示例:

    python src/sync_ownedby.py --source_json=ownedby.json --manual_url=https://cdn.jsdmirror.com/gh/Oaklight/onehub_prices@master/ownedby_manual.json
  3. 检查生成的 ownedby 表文件是否更新成功
  4. 运行脚本以同步价格数据:
    python src/sync_pricing.py [--json_file JSON_FILE] [--json_url JSON_URL]

    示例:

    python src/sync_pricing.py --json_url=https://cdn.jsdmirror.com/gh/Oaklight/onehub_prices@prices/oneapi_prices.json
  5. 检查生成的价格表文件是否更新成功

环境变量配置:

export ONEHUB_URL="https://onehub.your.link"  # 仅基础url,不要附带api subpath
export ONEHUB_ADMIN_TOKEN="your_admin_token"  # 网页管理后台获得
export SYNC_PRICE_OVERWRITE=True  # 是否覆盖现有价格
python src/sync_pricing.py [--json_file=./oneapi_prices.json] [--json_url=https://cdn.jsdmirror.com/gh/Oaklight/onehub_prices@prices/oneapi_prices.json]

注意事项:

  • 请确保网络连接正常,以便脚本能够访问外部 API
  • 如果需要手动调整价格数据,请编辑 manual_prices/ 目录中的 YAML 文件
  • 脚本支持通过环境变量进行配置,优先使用 url,其次使用文件

项目链接

📚 查看完整文档和源代码

项目维护者:Oaklight