> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 令牌需要设置可用模型吗？

> 详细说明API易令牌的可用模型设置机制、使用建议和常见场景

## 一般情况：不需要设置

<Info>
  **推荐做法**：创建令牌时，**不需要设置可用模型**，这样可以使用整个站点的所有模型。
</Info>

可用模型采用**白名单机制**：

* **不设置**：该令牌可以调用站点上所有 400+ 模型
* **设置后**：该令牌只能调用指定的模型，无法使用其他模型

如果您的业务场景多样化，设置可用模型会限制令牌的使用范围，反而影响灵活性。

## 为什么不建议设置？

### 1. 限制调用范围

假设您设置了可用模型为 `gpt-4o`、`claude-3-5-sonnet-20241022`，那么：

* ✅ 可以调用：`gpt-4o`、`claude-3-5-sonnet-20241022`
* ❌ 无法调用：`gemini-2.5-pro`、`deepseek-v3`、其他 400+ 模型

这会严重限制您的业务灵活性。

### 2. 模型别名问题

<Warning>
  **模型别名陷阱**：部分模型有别名，设置可用模型时容易出错。

  **案例**：

  * **别名**：`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"
    }
  }
  ```
</Warning>

### 3. 业务场景变化

随着业务发展，您可能需要测试或切换不同模型：

* 从 GPT-4 切换到 Claude 3.5
* 测试国产模型 DeepSeek、Qwen
* 尝试新发布的 Gemini 2.5

如果提前设置了可用模型，每次需要修改白名单，非常麻烦。

## 什么情况下需要设置？

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

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

<Card title="团队协作/朋友共享" icon="users">
  如果您将令牌 KEY 共享给同事或朋友，并希望他们**只能使用特定模型**（如 `gpt-3.5-turbo`），避免高价模型消耗您的余额，这种情况可以设置可用模型。

  **示例**：

  * 您的余额有限，只想让同事使用 `gpt-3.5-turbo`、`gpt-4o-mini`
  * 设置可用模型后，即使同事尝试调用 `o3`，也会被拒绝
</Card>

### 场景 2：预算控制

<Card title="严格成本管理" icon="dollar-sign">
  如果您为某个项目设置了严格的预算，只允许使用低成本模型，可以通过可用模型白名单限制：

  **示例**：

  * 项目预算有限，只允许使用 `deepseek-v3`（\$0.07/百万 tokens）
  * 禁止使用 `o3`（\$20/百万 tokens）避免超支
</Card>

### 场景 3：安全合规

<Card title="企业安全策略" icon="shield">
  部分企业有严格的 AI 模型使用规范，只允许使用经过审批的模型。

  **示例**：

  * 公司只允许使用 OpenAI 官方模型
  * 设置可用模型为 `gpt-4o`、`gpt-4.1`，禁止使用其他厂商模型
</Card>

## 如何设置可用模型？

如果您确实需要设置可用模型，步骤如下：

1. 登录 [API易令牌管理页面](https://api.apiyi.com/token)
2. 点击"新增 KEY"或编辑现有令牌
3. 在"可用模型"字段中选择允许的模型
4. 保存配置

<Tip>
  **使用正式名称**：设置可用模型时，建议使用模型的**官方正式名称**（如 `gemini-3-pro-image-preview`），而非别名（如 `nano-banana-pro`），避免调用失败。

  您可以在 [模型列表页面](/api-capabilities/model-info) 查看所有模型的正式名称。
</Tip>

## 总结

| 设置方式        | 优点                                            | 缺点                                       | 适用场景               |
| ----------- | --------------------------------------------- | ---------------------------------------- | ------------------ |
| **不设置可用模型** | ✅ 可使用所有 400+ 模型<br />✅ 无需担心别名问题<br />✅ 业务灵活性高 | ❌ 无法限制他人使用高价模型                           | 个人使用、开发测试、生产环境（推荐） |
| **设置可用模型**  | ✅ 严格控制模型使用范围<br />✅ 防止高价模型消耗余额                | ❌ 限制灵活性<br />❌ 可能遇到别名问题<br />❌ 需要手动维护白名单 | 共享令牌、预算控制、安全合规     |

<Info>
  **推荐做法**：除非有明确的控制需求，否则**不设置可用模型**，享受所有模型的访问权限。
</Info>

## 相关文档

* [如何创建 KEY？](/faq/token-management)
* [模型列表](/api-capabilities/model-info)
* [定价说明](/pricing)