租户地区切换与模型组可用范围
功能概述
| 项目 | 说明 |
|---|---|
| 适用角色 | 租户管理员（tenant_admin） |
| 更新日期 | 2026-06-01 |
gahorouter 将「所在地区」作为租户级属性，用于控制租户下所有成员能看到并使用的模型服务范围。注册时您会为租户选择一个地区（中国大陆 / 海外地区），之后系统会根据该地区自动过滤可用的模型组：
- 中国大陆租户：仅展示标记为「中国大陆」的模型组（DeepSeek、通义千问、GLM、Kimi、豆包、混元、讯飞星火等国产模型）
- 海外地区租户：展示全部模型组 —— 既包括「海外」模型组（Claude、GPT-4o、Gemini 等），也包括「中国大陆」模型组
地区一经设定后，只有租户管理员可以在「租户设置」页中修改。地区变更即时生效，会立即影响租户下所有成员看到的模型组列表、API Key 可绑定的分组、以及 Dashboard / 使用量等页面。
核心概念：地区标签 vs 租户地区
理解两者的关系是理解整个功能的关键：
| 概念 | 作用对象 | 取值 | 由谁设置 |
|---|---|---|---|
| 模型组的「服务地区」 | 每一个模型组 | 🇨🇳 中国大陆 / 🌍 海外 | 系统管理员在后台配置 |
| 租户的「所在地区」 | 整个租户 | 🇨🇳 中国大陆 / 🌍 海外地区 | 租户管理员（注册时初选，后续可改） |
可见规则：
| 租户地区 | 可见的模型组（按服务地区） |
|---|---|
| 🇨🇳 中国大陆 | 仅中国大陆 |
| 🌍 海外地区 | 中国大陆 + 海外 = 全部 |
简单记忆：中国大陆租户只能看到国内模型组；海外地区租户可以看到全部模型组（国内 + 海外）。海外地区是「超集」，国内地区是「子集」。
前置条件
- 您已注册 gahorouter 并以 租户管理员 身份登录
- 地区变更会影响租户下所有成员，请在团队沟通后再操作
- 如果您有正在使用的 API Key 绑定了可能不再可用的模型组，系统会在修改弹窗中提前告知
功能入口
在「租户信息」卡片中，您会看到「所在地区」字段和右侧的 「修改地区」 按钮（仅租户管理员可见）。
查看租户当前地区
进入 租户设置 页，在「租户信息」卡片中找到「所在地区」字段。系统会以彩色徽章形式显示当前地区：
| 徽章 | 含义 | 颜色 |
|---|---|---|
| 🇨🇳 中国大陆 | 当前租户地区为中国大陆 | 红色 |
| 🌍 海外地区 | 当前租户地区为海外地区 | 绿色 |
普通成员也能看到「所在地区」信息，但看不到「修改地区」按钮。
查看可用的模型组
导航栏【可用模型组】
该页面展示当前租户下实际可用的所有模型组列表，包含以下信息：
| 列 | 说明 |
|---|---|
| 名称 | 模型组名称，例如「DeepSeek-V3 智能优选」 |
| 平台 | 供应商（如 DeepSeek、Anthropic、OpenAI 等） |
| 费率倍数 | 调用该组时按倍率消耗积分 |
| 启用状态 | 显示该组在当前租户下的启用状态 |
这个列表是系统按照「部署级 → 地区级 → 租户级」多层过滤后的最终结果，所以您看到的就是成员实际可用的模型组。
修改租户地区
操作步骤
第一步：进入租户设置页
第二步：点击「修改地区」按钮
在「所在地区」字段右侧点击 「修改地区」，弹出地区修改对话框。
第三步：选择目标地区
在「地区」字段中选择：
- 中国大陆：切换后只能使用「中国大陆」标签的模型组（国产模型）
- 海外地区：切换后可以使用全部模型组（国产 + 海外）
第四步：查看数据出境合规提示
选择后，弹窗中会展示合规提示，说明数据处理的地域和相关隐私政策。请仔细阅读并确认您知悉相关责任。
第五步：点击「确认修改」
系统会立即更新租户地区。
业务规则
- 仅租户管理员可修改：普通成员看不到「修改地区」按钮，也无法直接调用修改接口
- 当前地区与所选地区相同时：「确认修改」按钮不可点击
- 修改即时生效：确认后立即影响租户下所有成员的模型组可见性，无需重新登录
- 影响范围：
- 可用模型组页面
- API Keys 创建时的分组选择器
- Dashboard 的模型组概览
- 使用量统计的分组展示
地区切换后的影响
从「海外地区」切换到「中国大陆」
场景举例：原本在海外注册的团队搬迁回国内，或需要满足中国大陆合规要求。
| 变化 | 说明 |
|---|---|
| 海外模型组 | 全部不可见，列表中消失 |
| 国产模型组 | 继续可见 |
| 原本绑定海外分组的 API Key | 置空待重新分配 |
| 已分配的积分余额 | 不受影响，余额不变 |
| 历史用量数据 | 不受影响，历史数据保留 |
| 正在进行中的 API 调用 | 已发出的调用正常完成，后续调用按新地区规则 |
从「中国大陆」切换到「海外地区」
场景举例：中国大陆租户需要使用 Claude、GPT-4o 等海外模型。
| 变化 | 说明 |
|---|---|
| 海外模型组（🌍 Overseas） | 变为可见，出现在列表中 |
| 国产模型组（🇨🇳 CN） | 继续可见（海外地区租户可以看全部） |
| 原有 API Key | 不受影响（原本绑定的国产分组对海外地区租户同样可用） |
| 数据出境责任 | 需要您自行评估和承担合规责任 |
⚠️ 切换到海外地区后，您的数据可能会被传输至中国大陆境外的第三方模型服务商处理。请确认这符合您所在地区的法律法规要求。
常见问题
Q1：为什么我看不到 Claude / GPT-4o / Gemini 等模型？
A：大概率是因为您的租户地区被设置为「中国大陆」。根据合规要求，中国大陆租户默认只能使用国产模型组。如果您确实需要使用海外模型，请：
- 前往 租户设置 页
- 点击「所在地区」旁的「修改地区」
- 选择「海外地区」并确认
Q2：修改地区后成员需要重新登录吗？
A：不需要。地区修改即时生效，成员刷新页面即可看到最新的模型组列表。
Q3：修改地区会影响我的余额或已充值的积分吗？
A：不会。地区只影响「哪些模型组可见和可用」，不影响任何余额、充值记录、用量数据或已开具的发票。
Q4：为什么普通成员看不到「修改地区」按钮？
A：地区变更会影响整个租户，只有租户管理员有权限修改，普通成员只能查看当前地区。这是为了避免个别成员擅自变更影响全团队。
Q5：切换后旧的 API Key 还能继续调用吗？
A：
- 如果原绑定的分组在新地区下仍然可用（例如从中国大陆切换到海外地区，原有的国产分组仍然可用）：可以继续正常调用
- 如果原绑定的分组在新地区下不可用（例如从海外地区切换到中国大陆，原有的海外分组不再可用），需重新配置 API 绑定的分组
Q7：我选择的地区下没有任何可用模型组怎么办？
A：请联系系统管理员确认：
- 系统管理员是否在后台为您的目标地区配置了对应的模型组
- 您的租户是否被管理员限制了特定分组的访问权限
Q9：不同成员可以设置不同的地区吗？
A：不可以。地区是租户级属性，同一租户下所有成员共享同一地区。这是为了简化合规管理，避免同租户内不同成员出现合规差异。
Q11：我是从海外切到国内，之前已经付费充值了海外模型可以继续用吗？
A：不行。切换到「中国大陆」后，所有标记为「海外」的模型组立即不可见，无论是否付费过。余额会保留，但只能用于调用国产模型组。如需继续使用海外模型，请切换回「海外地区」。
Q12：切换地区时弹窗加载很久没反应？
A：弹窗切换地区选项后会自动进行预检（检查受影响的 API Key），有轻微延迟属正常现象。如果长时间无响应，请刷新页面重试；若仍有问题，请联系客服。
注意事项
- 地区变更是全租户行为：请在变更前与团队沟通，避免造成成员困惑
- 数据出境责任自负：选择「海外地区」即表示您知悉并同意数据可能被传输至境外，请依据所在地法律法规评估合规性
- 余额与订单不受影响：地区变更只改变可见性，不影响余额、订单、发票、用量数据
- 建议在低峰期变更：避免在业务高峰期切换地区，防止正在进行的调用受到影响
- 不确定选哪个？ 国内运营团队/中国大陆用户 → 选「中国大陆」；全球团队/需要 Claude/GPT-4o → 选「海外地区」
联系我们
如果在使用过程中遇到任何问题，请及时联系我们。