提供商与路由

平台上的每个模型背后可能由**多个提供商（Provider）**节点支撑。您可以在令牌中配置路由策略，也可以通过请求头对单次请求进行临时覆盖。

什么是提供商

提供商是按来源与成本组织的服务节点——不同提供商的费率倍数与可用模型范围各不相同。当您发起请求时，系统会根据您的令牌配置自动选择可用的提供商；若某个提供商失败或超时，系统会自动切换到其他节点重试，整个过程对您的代码完全透明。

可用提供商

ID	名称	说明
official	官方直连	聚合 OpenAI、Anthropic、Google 等各大官方平台直连节点的提供商组，稳定性最高
official_cheap	官方（折扣）	官方渠道的成本优化版本，价格更低且保持较高稳定性
mix	混合渠道	多来源混合渠道，价格最低、模型覆盖面最广

关于 official

official 是一个提供商组，打包了 OpenAI、Anthropic、Google、DeepSeek 等主要官方平台的节点。选择 official 后，系统会在所有官方节点间进行智能路由与故障转移，无需逐个指定厂商。

如何选择

您的需求	推荐配置
极致稳定，价格不敏感	official
兼顾稳定与性价比	official_cheap
成本最低，可接受少量波动	mix
优先折扣官方，失败回落混合	official_cheap,mix

在令牌中配置提供商

创建或编辑令牌时，可以设置该令牌的默认路由行为。

提供商列表

指定该令牌允许使用的提供商。

• 留空（推荐）：自动在所有可用提供商间路由，可用性最佳
• 单个提供商：如 official，仅通过官方节点路由
• 多个提供商：逗号分隔，如 official_cheap,mix，按顺序或排序策略依次尝试

仅使用指定提供商（Provider-Only）

• 关闭（默认）：优先使用指定提供商，全部失败时回落到其他提供商
• 开启：严格限定在指定提供商内，全部失败则直接返回错误，不做回落

排序策略

指定多个提供商时，控制尝试顺序：

• 手动（默认）：按您填写的顺序尝试
• 延迟：优先响应最快的提供商
• 价格：优先成本最低的提供商
• 吞吐量：优先吞吐最高的提供商

单次请求覆盖提供商

您也可以通过请求头对单次请求临时覆盖令牌设置，无需修改令牌。

请求头	作用
X-Provider-Order	指定本次请求使用的提供商及顺序
X-Provider-Only	"true" 开启严格模式——禁止回落
X-Provider-Sort	覆盖排序策略（latency / price / throughput）
X-Provider-Ignore	本次请求跳过的提供商，在令牌配置基础上叠加

通过请求头指定的提供商仍受您账号权限的约束。

示例

优先折扣官方，失败回落混合渠道

curl https://api.calgine.com.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "X-Provider-Order: official_cheap,mix" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}'

严格仅走官方，禁止回落

curl https://api.calgine.com.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "X-Provider-Order: official" \
  -H "X-Provider-Only: true" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-4-5-20251101", "messages": [{"role": "user", "content": "你好"}]}'

在 SDK 客户端中设置默认请求头

Python

import openai

client = openai.OpenAI(
    api_key="sk-your-token",
    base_url="https://api.calgine.com.cn/v1",
    default_headers={
        "X-Provider-Order": "official_cheap,mix",
    }
)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-token",
  baseURL: "https://api.calgine.com.cn/v1",
  defaultHeaders: {
    "X-Provider-Order": "official_cheap,mix",
  }
});