模型与模型配置

查询可用模型Copy Anchor Link

每个密钥能调用的模型不同。用你自己的密钥查询模型列表：

curl https://api.lynshen.org/v1/models \
  -H "Authorization: Bearer $LYNSHEN_API_KEY"

返回示例（已截断）：

{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-5", "object": "model", "created": 0, "owned_by": "monoize" },
    { "id": "deepseek-v4-pro", "object": "model", "created": 0, "owned_by": "monoize" },
    { "id": "gpt-5.5", "object": "model", "created": 0, "owned_by": "monoize" },
    { "id": "gpt-image-2", "object": "model", "created": 0, "owned_by": "monoize" }
  ],
  "models": []
}

• data[].id 是请求中 model 字段要填写的值。列表按 id 字母顺序排列。
• models 字段供 Codex 读取模型元数据。只有管理员为 Codex 配置的模型才会出现在这个字段中。其他客户端可以忽略它。
• 列表只包含你的密钥有权访问的分组中的模型。密钥开启了模型限制时，列表只包含允许的模型。
• 列表不反映上游的实时健康状态。列表中的模型偶尔也会暂时不可用。

本指南中的模型名都是示例。实际可用的模型以你的 /v1/models 结果为准。

模型命名Copy Anchor Link

模型 ID 是网关的逻辑名称。同一个模型 ID 在网关后面可以对应多个上游服务商。网关按分组顺序和优先级选择上游，并在可重试的失败后切换到下一个上游。

在模型广场可以查看公开模型、所属分组和每百万 Token 的价格区间。例如：

模型 ID 区分大小写，必须与列表中的值完全一致。请求了不存在的模型时，网关返回 HTTP 404 model_not_found。

分组Copy Anchor Link

模型广场把模型放在分组中，例如“国内模型分组”和“海外模型分组”。分组决定请求走哪一批上游。

• 创建密钥时不选分组，密钥可以使用你有权访问的全部分组。
• 选了一个或多个分组时，密钥只路由到这些分组。排在前面的分组优先。
• 两个分组都提供同一个模型时，分组顺序决定先用哪一个。

分组和其他密钥选项的说明见 API 密钥。

用密钥控制模型Copy Anchor Link

在令牌管理中编辑密钥，可以设置以下选项：

模型重定向适合这种情况：工具写死了一个模型名，但你想把它换成另一个模型。例如，把 claude-haiku-.* 重定向到 deepseek-v4-pro。

按请求限制价格倍率Copy Anchor Link

同一个模型的不同上游可能有不同的价格倍率。你可以在单个请求中设置倍率上限，网关会跳过倍率更高的上游：

curl https://api.lynshen.org/v1/chat/completions \
  -H "Authorization: Bearer $LYNSHEN_API_KEY" \
  -H "X-Max-Multiplier: 1" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Hi"}]}'

也可以在请求体中写 "max_multiplier": 1。请求中的值只能降低密钥上设置的倍率上限，不能提高它。没有符合条件的上游时，网关返回 HTTP 503 no_healthy_upstream。

推理强度Copy Anchor Link

网关把三种协议的推理参数统一为以下级别：

每种协议的写法：

不传推理参数时，上游使用模型的默认行为。网关会把级别转换成上游需要的格式。例如，调用较早的 Claude 模型时，high 会变成 budget_tokens: 16384。完整的映射和展示方法见思维链（推理）。

在工具中配置模型Copy Anchor Link

大多数编程工具要求你为自定义模型填写以下信息。请按模型官方文档填写，网关的 /v1/models 不返回这些值。

各工具的具体写法见工具接入。