API 密钥与路由

一个 Key 就是一条路由规则：它决定请求可以到达哪些厂家、哪些模型，以及网关在多个定价分组之间如何自动选择。Key 在控制台「API 密钥」页面创建，形如 sk-xxxxxxxx。

一、三种路由模式

创建 Key 时选择「路由方式」，三种模式覆盖绝大多数场景：

模式可访问范围适合
按厂家选择默认所选厂家的全部模型（如 Anthropic = 全部 Claude），网关在该厂家的各分组内智能路由Claude Code / Codex 等单厂家客户端，按团队或项目分 Key
按模型选择只放行勾选的模型，可跨厂家；仍按最便宜可用分组路由给下游系统或外包团队限定可用模型
全部模型与厂家站内全部模型，无限制自己使用、Cherry Studio / Chatbox 等多模型客户端
厂家与模型名的关系

请求体里的 model 决定调用什么模型；Key 的路由模式决定这个模型允不允许以及走哪个分组。用按厂家（Anthropic）的 Key 去调 gpt-5.6-terra 会返回 403，换成「全部模型与厂家」或在「按模型」里勾上即可。

二、智能路由怎么选分组

同一个模型往往同时存在于多个定价分组（例如 claude-opus-5-5 同时在 Claude 企业版与编程套餐分组）。网关按下面的顺序为每次请求挑分组：

  1. 按真实扣费从低到高排序

    候选 = 你账户可用的分组中含该模型的分组，按折扣后的实际价格升序；同价按分组默认顺序。

  2. 最便宜的分组优先

    首选最便宜的一档；该分组没有该模型的可用渠道时，自动升到下一档。

  3. 故障自动切换

    上游返回错误时在同分组内换渠道重试，仍失败则升档重试；全部失败才把错误返回给你。

  4. 兜底分组

    仅存在于「无限制版」分组的模型，会在常规分组都没有时才命中；「多媒体」分组的模型同理（只在该分组存在，「全部模型与厂家」路由也能调到）。

因此通常不需要手动选分组；用量明细中的每一条记录都会标明实际命中的分组与单价。

三、分组体系

分组是定价与上游资源池的单位。模型列表里的分组徽标含义如下：

分组含义典型
企业版官方满血、官方母号、无客户端限制，全模型长上下文、图片、搜索；适合大项目主要生产力Claude 企业版、GPT 企业版、Gemini 企业版、GLM / Kimi / DeepSeek / Qwen 企业版
经济版特价号池，价格更低；GPT 经济版限制 Codex 客户端且不能生图，部分不保障缓存命中率Claude 经济版、GPT 经济版、Gemini 经济版、GLM 经济版
学习版引流特价分组，不参与智能路由自动兜底，需单独选用Claude 学习版
工作流官方原价，提供厂家完整型号目录（含历史型号）；适合非编程工具链与批处理GPT / Claude / GLM / Gemini / Cohere / Mistral 工作流
套餐编程套餐订阅分组：按套餐并发与额度计费，用尽后回落钱包Claude Code / Codex 套餐
福利 / 免费免费或福利分组，不保障可用率；仍需账户为正余额DeepSeek 福利免费版、TypeSafe 福利版
多媒体第三方未审查号池的图片 / 视频模型，图片按张、视频按秒（分辨率不同价）计费Seedance / Seedream / Wan 3.0 / Berry / MiniMax H3 / Qwen Image / Z-Image / 换脸
无限制版未删减（Uncensored）与消融（Abliterated）模型GLM-5.3 / GLM-5.3 Flash / GLM-4.7 Flash / DeepSeek V4.1 Flash / Qwen3.8 27B 无限制、Roleplay

每个分组的折扣、按模型单价与分档价见控制台模型广场，价格以那里为准。

四、额度模式

每个 Key 可独立设置消费上限，三选一：

模式说明
不限额只受账户余额限制（默认）
固定总额度该 Key 累计消费到上限后拒绝请求（429），可随时在控制台调高
周期额度按日 / 周 / 月自动重置；周期锚定你保存设置的那一刻，每个整周期清零一次

此外可以设置 过期时间与 IP 白名单；Key 被删除后立即失效。

五、并发与速率限制

六、用户等级与折扣

账户按累计消费自动评定等级（T0 → T1 → T2 → V1 → V2），等级越高在各分组的折扣越低；等级与折扣矩阵在模型广场可见。等级作用于账户下全部 Key，无需重建 Key。

七、建议做法

全部文档