搜索文档...

开始输入以搜索文档

平台指南

分组固定

将模型锁定到特定提供方分组及其费率,替代自动最便宜路由。

自动路由与固定

每个模型由一个或多个提供方分组提供服务,各有各的价格。密钥默认使用 auto:每个请求都会路由到当前可用的最便宜分组。

固定按模型覆盖这一行为:你精确选择它可以使用哪些分组,计费也锁定为这些分组的费率。当你需要特定提供方的质量或地区,或需要不会波动的费率时很有用。

查看分组价格

每个模型详情页的 Group Pricing 区块列出各分组的输入与输出价格;模型列表中的折扣徽章始终反映最便宜的分组。

模型详情页上的分组价格表

在密钥上固定分组

打开 API 密钥,创建或编辑密钥并打开分组选择器。搜索模型并点击,勾选一个或多个提供方分组,按最便宜优先排序并带有费率倍数。未改动的模型保持 auto。

密钥编辑器中的按模型提供方分组选择器

已固定的模型会浮到顶部,并带有显示锁定分组数量的徽章;「全部清除」可将密钥恢复为完全 auto。密钥列表中已固定的密钥显示为 auto +N。

固定请求如何路由

已固定的模型只在其固定分组内路由:先尝试最便宜的分组,出错或宕机时自动切换到下一个。实际服务请求的分组的费率即为计费费率。

请求上显式的 X-Group 头仍然优先于固定,未固定的模型继续按最便宜可用路由。

将固定与关注搭配使用,即可在分组调价或宕机时第一时间知晓,请参阅: 通知

固定分组全部宕机时

如果某模型的所有固定分组都不可用,而其他提供方仍在服务它,请求会返回针对性的错误而不是笼统的繁忙消息:

json
{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

放宽或移除密钥上的固定,或稍后重试。模型本身仍然在线。