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

# 模型与定价

> 本文档说明如何查询平台支持的模型、理解模型定价及费用的计算方式。

本文档说明如何查询平台支持的模型、理解模型定价及费用的计算方式。

<Columns cols={3}>
  <Card title="按模型选择" icon="brain-circuit">
    模型广场展示供应商、能力标签、上下文长度和价格。请求中的 `model` 字段应完全使用页面显示的名称。
  </Card>

  <Card title="按用量计费" icon="chart-no-axes-combined">
    大多数模型按输入 Token 与输出 Token 分别计费，部分图像或专用模型按调用次数计费。
  </Card>

  <Card title="按日志复盘" icon="list-checks">
    用量日志记录模型、Token、状态与费用，适合排查异常请求和优化成本。
  </Card>
</Columns>

## 查询模型与价格

进入模型广场（定价 / Pricing）页面，可查看平台当前支持的全部模型及其价格。页面提供以下信息：

* 模型列表：模型名称、所属供应商及能力标签。
* 价格信息：输入价、输出价及缓存价，均以每百万 Token 为单位。
* 筛选功能：按供应商、标签、能力（如视觉、函数调用）筛选。
* 模型详情：查看单个模型支持的接口类型、上下文长度及计费方式。

首页的热门模型区块亦展示部分常用模型的价格概览。

## 模型名称的使用

模型广场中显示的模型名称（如 `gpt-4o`、`claude-3-5-sonnet`、`deepseek-chat`）即为 API 请求中 `model` 字段应填入的值。使用时须注意：

* 名称须原样填写，区分大小写与连字符。
* 以模型广场显示的名称为准，不得自行推断。
* 同一供应商可能提供多个版本（如 `gpt-4o` 与 `gpt-4o-mini`），其能力与价格存在差异，应按需选择。

## Token 说明

Token 是大语言模型处理文本与计费的基本单位，可理解为字词的片段：

* 中文：约 1 个汉字对应 1 至 2 个 Token。
* 英文：约 1 个单词对应 1 至 2 个 Token，较长的单词可能被拆分为多个 Token。
* 标点、空格与换行同样占用 Token。

单次调用的 Token 消耗由输入 Token（请求内容）与输出 Token（模型返回内容）两部分构成。

## 计费模式

平台的模型采用以下两种计费模式之一，可在模型广场中查看。

### 按 Token 计费

价格以每百万 Token 为单位，区分输入价与输出价。单次费用的计算公式如下：

```text theme={null}
单次费用 = ( 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价 ) × 分组倍率
```

说明：

* 输出单价通常高于输入单价，因为内容生成的算力成本高于内容理解。
* 单价按每百万 Token 标注，实际费用按用量等比例折算。

计算示例（假设某模型输入价为 5 美元/百万 Token，输出价为 15 美元/百万 Token，分组倍率为 1）：

* 输入 10,000 Token，输出 2,000 Token。
* 输入费用 = 10,000 ÷ 1,000,000 × 5 = 0.05 美元
* 输出费用 = 2,000 ÷ 1,000,000 × 15 = 0.03 美元
* 单次总费用 = ( 0.05 + 0.03 ) × 1 = 0.08 美元

### 按次计费

部分模型（如部分图像生成模型）按调用次数收取固定费用，与 Token 数量无关。模型广场将标明此类模型的单次价格。

## 影响费用的因素

| 因素   | 说明                         |
| ---- | -------------------------- |
| 模型价格 | 不同模型价格差异显著，能力更强的模型通常价格更高   |
| 分组倍率 | 用户所属分组（如默认、VIP）可能对应不同的价格倍率 |
| 输入长度 | 上下文越长，输入 Token 越多          |
| 输出长度 | 生成内容越多，输出 Token 越多         |
| 缓存命中 | 命中缓存的部分通常按更低价格计费           |

分组倍率的详细说明参见 [分组与订阅](/zh/platform/groups-and-subscriptions)。

## 缓存价格

部分模型支持提示缓存（Prompt Caching）。当请求包含重复的前缀内容（如固定的系统提示词或长文档）时，重复部分可被缓存，后续命中缓存的 Token 将以更低价格计费。

模型广场中的缓存价格列以「输入/输出」形式展示：

* 左侧为缓存读取价（命中缓存的输入）。
* 右侧为缓存写入价（写入缓存的成本）。
* 若某一侧未配置，则显示为 `-`（例如 `-/$3` 表示仅配置了写入价）。

## 成本优化建议

* 按任务复杂度选择模型：简单任务（分类、格式化、基础问答）使用较低价格的模型，复杂任务（推理、长文创作）使用能力更强的模型。
* 控制上下文长度：仅保留必要内容，避免传入无关的历史对话或超长文档。
* 限制输出长度：通过 `max_tokens` 参数控制模型的最大生成量。
* 利用缓存：将固定不变的系统提示与参考文档置于请求前部，以降低重复成本。
* 定期复盘：通过 [用量日志](/zh/platform/dashboard-and-usage) 分析高消耗调用并进行优化。

<Tip>
  生产环境建议为每个项目单独创建 API 密钥，并设置密钥额度上限。额度上限不是预算系统的替代品，但能降低误调用或泄露后的损失。
</Tip>

## 价格更新时效

平台的模型列表与价格存在短时缓存（约数分钟）。新增模型或价格调整后若未即时生效，请稍候数分钟或刷新页面。

## 后续步骤

* 了解充值与账单：参阅 [付款与账单](/zh/platform/billing)。
* 了解分组倍率：参阅 [分组与订阅](/zh/platform/groups-and-subscriptions)。
* 开始调用模型：参阅 [快速入门](/zh/overview/quickstart)。