公司 AI 网关分组与使用指南
一、员工资源分组
| 名称 | 分组 | 主要用途 | 内部额度扣减倍率 |
|---|---|---|---|
| 国内常用 | default | 普通员工日常问答、文案、分析 | 0.5 |
| 编程订阅 | coding | 智谱、Kimi 编程模型,研发优先使用 | 0.3 |
| 国内按量 | domestic_payg | 国内模型补充入口,可用模型以目录为准 | 1.2 |
| GPT / Grok | gpt_grok | GPT、Grok 模型 | 0.3 |
| Claude / Gemini | claude_gemini | 按任务需要使用 | 1.5 |
| 图片生成与编辑 | image | 各品牌图片生成、改图模型 | 0.5 |
以上为当前生效的内部额度扣减倍率,不是模型能力评分,只用于内部额度核算。模型仍按页面显示的参考价格以及输入、输出、缓存等规则分别计算;1.2、1.5 表示相应的额度扣减比例,不称为优惠折扣。后续如调整倍率,会另行通知。
二、日常怎样选择
- 普通员工先使用国内常用 default;需要编程等能力时,也可在授权和额度范围内使用 coding。
- 工程师及高用量人员默认 coding,优先使用智谱、Kimi 订阅资源,不使用 default。
- 按任务需要选择获授权的 domestic_payg、GPT/Grok、Claude/Gemini 等补充入口。生成、编辑图片选择 image。
- 可用模型以网关目录为准。选组不代表每个品牌、型号都已接入,也不保证当前一定有剩余额度。
三、切换后的个人密钥与客户端步骤
- 刷新网关控制台。工程师原先绑定 default、VIP、SVIP 或折扣组的旧密钥可能提示无权访问,请改用 coding 或其他新分组密钥。
- 新建个人密钥时使用默认的“跟随用户组”:普通员工对应 default,工程师对应 coding,不默认使用 auto 自动分组。
- 需要其他资源组时,在网关创建或选择属于该组的密钥,再在客户端保存对应预设。具体字段和操作以管理员提供的客户端适配说明为准。
- 预设建议命名为“国内常用”“编程订阅”“国内按量”“GPT/Grok”“Claude/Gemini”“图片生成与编辑”,避免将不同用途混在一个不易辨认的配置中。
- 调用时同时核对模型与密钥/预设。只改模型名称不会改变密钥所属资源组;模型必须是该组允许使用的型号。
- 普通员工的旧 VIP、SVIP、折扣及视频组密钥暂时保留过渡访问。不要批量删除旧密钥;若旧配置报错,先核对密钥分组和预设,再联系管理员。
个人密钥不要共享给同事或放进项目仓库。项目程序应使用独立凭证,不混用个人或 Root 的工作密钥。
四、套餐额度、账号额度与模型异常
上游套餐可用量与个人账号额度是两回事:套餐有余额,不代表个人账号预算足够;个人账号有余额,也不代表所选套餐或模型当前可用。新建密钥、换组或换模型不会自动增加账号总额度。
GLM 单模型失败不必然代表同组 Kimi 也无法使用。单模型异常可能不影响其他模型;同一上游共享总额度用尽,或整渠道被禁用且没有可用备用渠道时,才可能连带影响其承载的其他模型。
明确提示套餐用尽时,可选择其他获授权且可用的资源组与模型,仍受账号预算约束。工程师不能退回 default。遇到限频、并发或临时服务错误,不要把所有 429 都当成套餐用完,也不要连续大量重试。
模型广场的性能信息是历史统计,用于参考,不代表实时剩余额度、当前服务状态或必然可用。
五、常见问题与处理
| 现象 | 优先核对与处理 |
|---|---|
| 无权访问分组 | 核对账号授权、密钥分组与客户端预设;被改组的账号按提示重登。不通过借用他人密钥绕过限制。 |
| 模型列表不符或找不到模型 | 刷新模型列表,核对所选密钥的资源组及模型限制。客户端旧列表可能没有更新;以网关目录和通知为准。 |
| 明确提示套餐额度用尽 | 改选获授权的补充组与模型;工程师不转回 default。其他组也可能没有可用资源,不能理解为无限兜底。 |
| 临时限频、并发限制或 429 | 降低并发、稍后重试;查看具体文字报错。持续异常时反馈,不仅凭状态码判断套餐耗尽。 |
| 个人账号额度不足 | 联系管理员核对预算。新建密钥或换组不会增加账号总额度。 |
| API Key 无效 | 核对客户端是否使用正确且完整的密钥、是否误带空格、是否过期或被停用。不要把完整密钥发群里,请管理员协助核查。 |
六、项目程序与后台 Agent 接入清单
Embedding、ASR、重排、TTS 等技术能力统一归入“应用服务” app_services,当前内部额度扣减倍率为 1。现阶段已接入能力以模型目录为准,不应据此认为尚未接入的 ASR 等能力已经供应;视频短期不纳入本轮体系。
这里的后台 Agent 指项目服务、后台程序或无人值守流程,不等同于工程师本人使用的编程客户端。普通员工目前可以选择 app_services,但一般由公司程序或 Agent 使用。
接入前由项目负责人向管理员确认:
- 项目名称、负责人、必需能力、预计调用规模和预算。
- 独立程序账号与独立 API Key,明确资源组和必要模型白名单。
- 凭证存放在受控配置中,不写入 Git、公告或聊天消息;不混用个人或 Root 工作密钥。
- 如程序还需要文本推理,另行申请相应资源授权,不自动继承员工 default 或 coding 套餐。
七、后续使用与问题反馈
普通员工优先 default,研发优先 coding,再按任务需要选择其他获授权模型。不要因一次模型报错就反复创建密钥或批量改配置。重要结果应核验,对外发布、业务决策或代码上线前进行人工检查。
反馈问题时请提供模型名称、密钥分组/客户端预设名称、发生时间和文字报错;不要发送完整 API Key、密码或敏感输入内容。后续分组、倍率和使用方式调整,会按实际情况另行通知。
