> ## 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易令牌的5种计费模式、使用场景和最佳实践

## 快速答案

<Info>
  **推荐设置**：创建令牌时，\*\*计费模式选择"按量优先"\*\*即可，适用于绝大多数场景。
</Info>

虽然系统提供了 5 种计费类型，但\*\*默认使用"按量优先"\*\*就能覆盖所有模型的调用需求。

<img className="block dark:hidden" src="https://mintcdn.com/apiyillc/Cic_8J3gmaYuqnbs/images/token-billing-modes.png?fit=max&auto=format&n=Cic_8J3gmaYuqnbs&q=85&s=0648c415db25659d45c57f46fab8ceb2" alt="令牌计费模式选择" width="1272" height="888" data-path="images/token-billing-modes.png" />

<img className="hidden dark:block" src="https://mintcdn.com/apiyillc/Cic_8J3gmaYuqnbs/images/token-billing-modes.png?fit=max&auto=format&n=Cic_8J3gmaYuqnbs&q=85&s=0648c415db25659d45c57f46fab8ceb2" alt="令牌计费模式选择" width="1272" height="888" data-path="images/token-billing-modes.png" />

## 5 种计费模式详解

### 1. 按量计费

**定义**：根据输入和输出的 **Token 数量**计费，使用多少 Tokens 扣多少费用。

**适用模型**：

* **文本生成模型**：GPT-4、Claude、Gemini、DeepSeek 等
* **多模态理解模型**：支持图片/音频输入的模型
* **特殊图片模型**：`gpt-image-1`（按 Tokens 计费）

**计费方式**：

```
总费用 = (输入 Tokens × 输入价格) + (输出 Tokens × 输出价格)
```

**示例**：

* `gpt-4o`：输入 \$5/百万 tokens，输出 \$15/百万 tokens
* `claude-3-5-sonnet-20241022`：输入 \$3/百万 tokens，输出 \$15/百万 tokens

<Tip>
  **gpt-image-1 特殊说明**：虽然是图片生成模型，但按 Tokens 计费。影响 Tokens 的因素包括：

  * 图片分辨率（1024x1024、1792x1024 等）
  * 图片质量（standard、hd）

  OpenAI 官方提供了详细的计费表，不同分辨率和质量对应不同的 Token 消耗。
</Tip>

***

### 2. 按次计费

**定义**：每次调用**固定扣费**，不受输入和输出 Tokens 影响。

**适用模型**：

* **图片生成模型**：DALL-E、Flux、Sora Image 等（除了 gpt-image-1）
* **视频生成模型**：Sora Video、VEO 等

**计费方式**：

```
总费用 = 调用次数 × 单次价格
```

**示例**：

* `gemini-3-pro-image-preview`（别名 `nano-banana-pro`）：\$0.09/次
* `sora_video2`：\$0.15/次（10秒视频）
* `flux-1.1-pro`：\$0.04/次

<Note>
  **按次计费的优势**：

  * 价格透明，每次生成固定费用
  * 无需计算 Token 消耗
  * 适合图片/视频等固定输出场景
</Note>

***

### 3. 混合计费

**定义**：同时支持按量和按次两种计费方式，根据模型自动选择。

**状态**：⚠️ **不适用**

<Warning>
  目前 API易 平台**不推荐使用"混合计费"模式**，该模式可能导致计费混乱。建议使用"按量优先"替代。
</Warning>

***

### 4. 按量优先（推荐）

**定义**：**智能计费模式**，当模型同时支持按量和按次计费时，**优先使用按量计费**；如果模型只支持按次，则自动切换为按次计费。

**为什么推荐？**

* ✅ **包含按次计费**：可以调用图片/视频等按次计费模型
* ✅ **包含按量计费**：可以调用文本/多模态等按量计费模型
* ✅ **自动适配**：系统自动选择最合适的计费方式
* ✅ **覆盖全场景**：400+ 模型全部支持

**计费逻辑**：

```
如果模型支持按量计费 → 使用按量计费
如果模型只支持按次计费 → 使用按次计费
```

**示例场景**：

| 模型                           | 计费方式 | 说明               |
| ---------------------------- | ---- | ---------------- |
| `gpt-4o`                     | 按量计费 | 文本模型，优先按量        |
| `gpt-image-1`                | 按量计费 | 图片模型但按 Tokens 计费 |
| `gemini-3-pro-image-preview` | 按次计费 | 图片模型，自动切换为按次     |
| `sora_video2`                | 按次计费 | 视频模型，自动切换为按次     |

<Info>
  **推荐理由**：使用"按量优先"令牌，可以调用所有模型，无需为不同模型创建不同计费模式的令牌。
</Info>

***

### 5. 按次优先

**定义**：当模型同时支持按量和按次计费时，**优先使用按次计费**；如果模型只支持按量，则自动切换为按量计费。

**适用场景**：

* 需要固定成本的场景
* 主要使用图片/视频生成模型

**计费逻辑**：

```
如果模型支持按次计费 → 使用按次计费
如果模型只支持按量计费 → 使用按量计费
```

<Note>
  **使用建议**：除非有明确的成本控制需求，否则建议使用"按量优先"，因为文本模型按量计费通常更划算。
</Note>

***

## 如何选择计费模式？

### 推荐方案（适合 95％ 用户）

<Card title="按量优先（默认推荐）" icon="star">
  **适用场景**：

  * 同时使用文本、图片、视频模型
  * 不想为不同模型创建不同令牌
  * 需要最大灵活性

  **优势**：

  * 覆盖所有 400+ 模型
  * 系统自动选择最优计费方式
  * 无需额外配置
</Card>

### 特殊场景

<Tabs>
  <Tab title="纯文本应用">
    **场景**：只使用 GPT、Claude、Gemini 等文本模型

    **推荐计费模式**：按量优先 或 按量计费

    **原因**：文本模型都是按量计费，两种模式效果相同
  </Tab>

  <Tab title="纯图片/视频应用">
    **场景**：只使用 DALL-E、Flux、Sora 等生成模型

    **推荐计费模式**：按量优先 或 按次优先

    **原因**：图片/视频模型大多按次计费，但"按量优先"也能自动适配

    **注意**：如果使用 `gpt-image-1`，必须使用"按量优先"或"按量计费"
  </Tab>

  <Tab title="成本控制">
    **场景**：严格控制预算，希望每次调用成本固定

    **推荐计费模式**：按次计费 或 按次优先

    **原因**：按次计费价格固定，便于成本预测

    **限制**：无法调用文本模型（如 GPT-4、Claude）
  </Tab>
</Tabs>

***

## 常见问题

<AccordionGroup>
  <Accordion title="为什么 gpt-image-1 需要按量计费令牌？">
    `gpt-image-1` 是 OpenAI 的官方图片生成模型，虽然是图片生成，但计费方式与文本模型类似，**按 Tokens 计费**。

    **计费因素**：

    * 图片分辨率（1024x1024 消耗约 5000 tokens，1792x1024 消耗约 8500 tokens）
    * 图片质量（HD 质量会增加 Token 消耗）

    **解决方案**：

    * 使用"按量优先"或"按量计费"令牌
    * 如果使用"按次计费"令牌，将无法调用 `gpt-image-1`
  </Accordion>

  <Accordion title="我已经创建了按次计费令牌，能改成按量优先吗？">
    **可以修改**。步骤如下：

    1. 登录 [API易令牌管理页面](https://api.apiyi.com/token)
    2. 找到对应的令牌，点击右侧的"编辑"按钮
    3. 在"计费模式"下拉菜单中选择"按量优先"
    4. 保存配置

    **注意**：修改后立即生效，不影响已有余额。
  </Accordion>

  <Accordion title="按量优先和按次优先有什么区别？">
    **优先级不同**：

    | 计费模式 | 当模型同时支持按量和按次时 | 适用场景              |
    | ---- | ------------- | ----------------- |
    | 按量优先 | 优先使用按量计费      | 主要使用文本模型，偶尔用图片/视频 |
    | 按次优先 | 优先使用按次计费      | 主要使用图片/视频，偶尔用文本模型 |

    **推荐**：大多数情况下使用"按量优先"即可。
  </Accordion>

  <Accordion title="如果选错计费模式，会调用失败吗？">
    **不会立即失败，但可能无法调用某些模型**。

    **示例场景**：

    * 如果令牌是"按次计费"，调用 `gpt-4o` 会失败（因为 gpt-4o 只支持按量计费）
    * 如果令牌是"按量计费"，调用 `gemini-3-pro-image-preview` 可能失败（因为该模型只支持按次计费）

    **解决方案**：使用"按量优先"避免这个问题。
  </Accordion>

  <Accordion title="混合计费为什么不适用？">
    **混合计费**在理论上可以同时支持按量和按次，但在实际使用中可能导致：

    * 计费逻辑不明确
    * 成本难以预测
    * 系统兼容性问题

    **替代方案**：使用"按量优先"可以达到相同效果，且更稳定可靠。
  </Accordion>
</AccordionGroup>

***

## 总结建议

| 计费模式     | 推荐指数  | 适用场景       | 覆盖模型                   |
| -------- | ----- | ---------- | ---------------------- |
| **按量优先** | ⭐⭐⭐⭐⭐ | 所有场景（默认推荐） | 所有 400+ 模型             |
| 按量计费     | ⭐⭐⭐   | 纯文本/多模态应用  | 文本模型 + gpt-image-1     |
| 按次计费     | ⭐⭐⭐   | 纯图片/视频应用   | 图片/视频模型（除 gpt-image-1） |
| 按次优先     | ⭐⭐    | 主要使用图片/视频  | 所有 400+ 模型             |
| 混合计费     | ❌     | 不推荐使用      | 可能导致计费混乱               |

<Info>
  **最佳实践**：创建令牌时，计费模式选择"**按量优先**"，可以覆盖所有使用场景，无需为不同模型创建不同令牌。
</Info>

## 相关文档

* [如何创建 KEY？](/faq/token-management)
* [令牌需要设置可用模型吗？](/faq/token-model-whitelist)
* [定价说明](/pricing)
* [模型列表](/api-capabilities/model-info)