跳转到主要内容

​
一般情况：不需要设置

推荐做法：创建令牌时，不需要设置可用模型，这样可以使用整个站点的所有模型。
可用模型采用白名单机制：
  • 不设置：该令牌可以调用站点上所有 200+ 模型
  • 设置后：该令牌只能调用指定的模型，无法使用其他模型
如果您的业务场景多样化，设置可用模型会限制令牌的使用范围，反而影响灵活性。

​
为什么不建议设置？

​
1. 限制调用范围

假设您设置了可用模型为 gpt-4o、claude-3-5-sonnet-20241022，那么：
  • ✅ 可以调用：gpt-4o、claude-3-5-sonnet-20241022
  • ❌ 无法调用：gemini-2.5-pro、deepseek-v3、其他 200+ 模型
这会严重限制您的业务灵活性。

​
2. 模型别名问题

模型别名陷阱：部分模型有别名，设置可用模型时容易出错。案例：
  • 别名：nano-banana-pro（友好的简称）
  • 正式名称：gemini-3-pro-image-preview（官方 API 名称）
如果您设置可用模型为 nano-banana-pro，但代码中调用 gemini-3-pro-image-preview，会返回错误：
{
  "error": {
    "message": "Model not allowed for this API key",
    "type": "invalid_request_error"
  }
}

​
3. 业务场景变化

随着业务发展，您可能需要测试或切换不同模型：
  • 从 GPT-4 切换到 Claude 3.5
  • 测试国产模型 DeepSeek、Qwen
  • 尝试新发布的 Gemini 2.5
如果提前设置了可用模型，每次需要修改白名单，非常麻烦。

​
什么情况下需要设置？

虽然不推荐，但以下场景可以考虑设置可用模型：

​
场景 1：共享令牌给他人

团队协作/朋友共享

如果您将令牌 KEY 共享给同事或朋友，并希望他们只能使用特定模型（如 gpt-3.5-turbo），避免高价模型消耗您的余额，这种情况可以设置可用模型。示例：
  • 您的余额有限，只想让同事使用 gpt-3.5-turbo、gpt-4o-mini
  • 设置可用模型后，即使同事尝试调用 o3，也会被拒绝

​
场景 2：预算控制

严格成本管理

如果您为某个项目设置了严格的预算，只允许使用低成本模型，可以通过可用模型白名单限制：示例：
  • 项目预算有限，只允许使用 deepseek-v3（$0.07/百万 tokens）
  • 禁止使用 o3（$20/百万 tokens）避免超支

​
场景 3：安全合规

企业安全策略

部分企业有严格的 AI 模型使用规范，只允许使用经过审批的模型。示例：
  • 公司只允许使用 OpenAI 官方模型
  • 设置可用模型为 gpt-4o、gpt-4.1，禁止使用其他厂商模型

​
如何设置可用模型？

如果您确实需要设置可用模型，步骤如下：
  1. 登录 API易令牌管理页面
  2. 点击”新增 KEY”或编辑现有令牌
  3. 在”可用模型”字段中选择允许的模型
  4. 保存配置
使用正式名称：设置可用模型时，建议使用模型的官方正式名称（如 gemini-3-pro-image-preview），而非别名（如 nano-banana-pro），避免调用失败。您可以在 模型列表页面 查看所有模型的正式名称。

​
总结

设置方式优点缺点适用场景
不设置可用模型✅ 可使用所有 200+ 模型
✅ 无需担心别名问题
✅ 业务灵活性高		❌ 无法限制他人使用高价模型个人使用、开发测试、生产环境（推荐）
设置可用模型✅ 严格控制模型使用范围
✅ 防止高价模型消耗余额		❌ 限制灵活性
❌ 可能遇到别名问题
❌ 需要手动维护白名单		共享令牌、预算控制、安全合规
推荐做法：除非有明确的控制需求，否则不设置可用模型，享受所有模型的访问权限。

​
相关文档