mixgateway.io

模型命名与路由

1. model 字段约定

网关用同一个 model 字符串同时表示 供应商（provider） 和 上游模型（modelId），中间用英文冒号分隔：

  • 格式：provider:modelId

示例：

  • DeepSeek 对话模型：deepseek:deepseek-chat
  • 仅写厂商侧模型名（若网关支持默认映射）：deepseek-chat
  • 其他托管方上的同名模型（示例）：AliyunBailian:deepseek-chat
  • DeepSeek 推理模型：deepseek:deepseek-reasoner
  • OpenAI GPT‑4.1 mini：openai:gpt-4.1-mini

其中：

  • provider — 网关内部使用的供应商标识，例如 deepseek、openai、siliconflow、AliyunBailian 等。
  • modelId — 与各供应商官方文档一致的模型名，例如 deepseek-chat、deepseek-reasoner、gpt-4.1-mini。

部分场景下可以 省略 provider: 前缀；仅传 deepseek-chat 时，网关可能按默认配置解析到对应供应商。

2. 路由行为（对调用方透明）

当你请求 POST https://api.mixgateway.io/v1/chat/completions 时：

  1. 网关从 model 中解析 provider 与 modelId（若只传 modelId 则走默认映射）。
  2. 选择实际上游地址与鉴权信息。
  3. 转发前可能把 model 改写成供应商真实 id（例如 deepseek-chat），并替换为正确的上游密钥。

业务应用一般 不必 自己维护「模型 → 上游」映射表；只要 model 对你的账号有效，网关会路由到预期供应商与模型。

3. 示例：从直连 DeepSeek 迁到网关

原先（直连 DeepSeek）：

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer {deepseek_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"Hi"}]
  }'

经由 mixgateway.io（请求体可保持不变，换 Base URL 与密钥）：

curl https://api.mixgateway.io/v1/chat/completions \
  -H "Authorization: Bearer {gateway_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"Hi"}]
  }'

常见改动：

  • Base URL — 从厂商域名改为 https://api.mixgateway.io/v1（具体是否含 /v1 以你们部署为准）。
  • Authorization — 从厂商 API Key 改为在 [控制台](/dashboard) 获取的 网关 API Key。

model、messages、temperature、max_tokens 等字段通常可保持不变。

也可显式写供应商：

"model": "deepseek:deepseek-chat"

4. 支持的供应商与模型

  • 官网 价格 页面可查看公开费率与模型概览。
  • 在 [控制台](/dashboard) 确认你的账号已开通的供应商与 modelId，并核对计费规则后再上生产流量。

延伸阅读