---
url: https://limapi.com/docs/platform/pay-as-you-go.md
---
# 按量付费（Pay As You Go）

* **计费模式**：预充值 + 按实际消耗实时扣费，用多少付多少
* **调用端点**：`https://limapi.com/api/v1`（OpenAI 兼容）、`https://limapi.com/api/anthropic`（Anthropic 兼容）
* **认证方式**：`Authorization: Bearer sk-ai-v1-xxx`，密钥以 `sk-ai-v1-` 开头

::: tip 生产环境可直接使用
按量付费**没有使用场景限制**，已上线的商业产品、面向终端用户的服务、Agent 业务系统都可以直接使用：默认不限每分钟请求数，失败任务自动退款，账单逐笔可查可导出。
:::

## 什么是按量付费

按量付费是 LimAPI 目前的主要计费方式。你先给账户充值，之后每次调用按该次请求的真实 token 用量与模型单价扣费，不预付固定月费、不承诺额度、也没有使用场景限制。

| 特性 | 说明 |
|------|------|
| **默认不限速率** | API Key 默认不设 RPM 上限，支持高并发调用 |
| **精准计费** | 按 token 级用量计费，输入与输出分别计价，账单逐笔可查 |
| **失败退款** | 视频等异步任务生成失败时自动退款，不占用余额 |
| **多级折扣** | 模型折扣自动匹配，账单中直接体现折后金额 |
| **完整可观测** | 调用流水、用量分析、成本分析、按 Key 归因，支持导出 |

## 计费口径

* **单价单位**：元 / 百万 token，**输入与输出分别计价**，各模型单价见模型详情页。
* **阶梯计费**：部分模型按输入长度分段定价（例如同一个模型在输入超过某个 token 数后单价上浮），调用前请查看模型详情页的分段说明。
* **缓存 token**：命中缓存的输入 token 按低于原价的折扣价计费；显式缓存写入按高于输入价的倍率计费。各模型倍率不同，以模型详情页标注为准。
* **工具调用费**：使用模型服务端工具（返回 `usage` 中的 `x_tools`）时，按调用次数额外计费。
* **计费以返回的 `usage` 为准**：账单里的 token 数与费用来自上游实际返回的用量，不是请求参数的估算值。

::: warning 余额扣到 0 以下
发起调用前只做「余额大于 0」的预检，实际扣费按该次调用的真实用量结算，因此最后一笔调用可能把余额扣到 0 以下。此时充值即可恢复调用，欠款不会被免除，但也不会产生额外费用。
:::

## 充值

1. 登录 [Portal 控制台](https://limapi.com/)，进入「充值」页面。
2. 输入充值金额：**单笔最低 ¥1，最高 ¥10,000**。
3. 使用**微信支付**完成付款（PC 端扫码、移动端唤起小程序），支付成功后余额**实时到账**。
4. 在「我的订单」中查看充值记录，支持按状态筛选与分页。

::: tip 订单规则

* 支付方式目前**仅支持微信支付**，暂不支持支付宝、Stripe 或对公转账。
* 创建后未支付的订单（`PENDING`）**超过 30 分钟自动关闭**；如已付款但订单被关闭，款项仍会入账。
* 组织场景由 OWNER 或 ADMIN 充值到组织资金池，再分配额度给成员，详见[组织用户使用指南](/platform/organization)。
  :::

## API Key

按量付费的 API Key 以 `sk-ai-v1-` 开头，一个账户可以创建多个 Key 用于区分项目或环境。

**你可以在 Portal 自助完成的操作：**

| 操作 | 说明 |
|------|------|
| 创建 Key | 在「API Keys」页点击「创建密钥」并命名；**完整密钥仅展示一次**，请立即复制保存 |
| 暂停 / 启用 | 暂停后该 Key 的所有请求立即被拒绝，可随时恢复 |
| 重置密钥 | 生成新的密钥串，旧密钥立即失效（用于泄露后止损） |
| 删除 | 永久删除该 Key |
| 查看用量 | 每个 Key 的调用量与消耗可在「API Keys」页与用量分析中查看 |

**需要联系平台支持配置的能力**（Portal 暂不开放自助编辑）：

| 能力 | 说明 |
|------|------|
| 单 Key 速率上限（RPM） | 默认不限；可为指定 Key 设置每分钟请求数上限 |
| 单 Key 额度上限 | 达到上限后该 Key 返回 `402 key_credit_exhausted`，适合按项目做预算封顶 |
| 额度阈值提醒 | 消耗达到上限的某个百分比时，响应头带 `X-Credit-Warning` |
| 模型白名单 | 限制该 Key 只能调用指定模型 |

::: warning 安全提示

* 不要把 API Key 提交到公开仓库或写进前端页面代码。
* 一旦泄露，立即在 Portal「重置密钥」，旧密钥会马上失效。
* Key 名称建议使用可识别的描述（如 `prod-backend`、`staging`），便于成本归因。
  :::

## 速率与并发

| 限制项 | 默认值 | 说明 |
|------|------|------|
| 每分钟请求数（RPM） | **不限** | Key 未配置 RPM 上限时不做限制；超限返回 `429 rate_limit` |
| 请求体大小 | **≤ 32 MB** | 超出返回 `413 request_body_too_large`；含内联图片、长上下文的请求请注意体积 |
| 超大请求并发 | **单租户 16 / 全局 24** | 仅请求体 **> 8 MB** 的调用占用该并发额度；超限返回 `429`，属内存保护措施，稍后重试即可。需要更高并发请联系平台支持 |

::: tip 响应头
每个通过鉴权的请求都会返回 `X-RateLimit-Limit` 与 `X-RateLimit-Remaining`（当前 Key 的 RPM 上限与剩余量），可据此做客户端限速。
:::

## 余额与错误码

| HTTP 状态码 | `error.type` | 含义与处理 |
|------|------|------|
| 402 | `insufficient_balance` | 账户余额不足，充值后重试 |
| 402 | `key_credit_exhausted` | 该 Key 的额度上限已用尽（账户余额可能仍充足），联系平台支持调整上限或换用其他 Key |
| 403 | `access_denied` | 未提供 API Key，或 Key 无效 / 已暂停 / 已删除 |
| 413 | `request_body_too_large` | 请求体超过 32 MB |
| 429 | `rate_limit` | 超过该 Key 的 RPM 上限，或超大请求并发额度已满（响应带 `Retry-After: 5`，可退避重试） |
| 502 | `no_provider_available` | 该模型当前没有可用渠道，稍后重试 |

注意错误体里 `error.code` 是**状态码字符串**（如 `"402"`），`error.type` 才是语义名。完整清单与排查建议见[错误码参考](/guide/errors)。

### 低余额提醒

在 Portal「设置 → 通知配置」中可自助开启余额提醒：

* 支持设置多档阈值（默认 **¥100 / ¥50 / ¥10**）。
* 通知渠道为**群机器人 Webhook**（企业微信 / 飞书 / 钉钉），不是邮件；填入机器人地址即可。
* 触发后由网关推送，无需轮询接口。

此外网关还提供**跑道预警**：按当前消耗速率推算余额即将耗尽时提前告警，避免在业务高峰期突然返回 `402`。

## 用量与账单

| 页面 | 能看到什么 |
|------|------|
| 充值 | 余额、充值记录、订单状态 |
| 调用流水 | 逐笔调用记录（模型、token 用量、费用、状态、上游请求 ID），支持按时间与租户筛选、游标分页、查看单笔详情 |
| 用量分析 | 时间序列趋势、模型维度统计、排行榜 |
| 成本分析 | 费用构成与省钱统计 |
| API Keys | 每个 Key 的调用量与消耗 |

* **导出**：用量明细可导出为 `.xlsx`，单次导出上限 **20,000 行**。
* **程序化查询**：账单与用量也可以通过[管理与平台 API](/guide/management) 拉取，便于接入自己的成本看板。

## 按量付费 vs 订阅制套餐

| 对比维度 | 按量付费 | [订阅制套餐](/platform/subscription)（即将上线） |
|------|------|------|
| 计费方式 | 预充值 + 按实际消耗扣费 | 固定月费 + 周期额度点 |
| 适用场景 | **生产环境、商业化产品**、Agent 业务系统 | 个人开发、学习探索、Vibe Coding |
| 速率限制 | 默认不限 RPM | 有 RPM 与滚动窗口限制 |
| 并发限制 | 仅超大请求有并发保护 | 同上，且窗口额度用满后回落按量 |
| 成本可预测性 | 随用量波动 | 固定月费，超出部分才按量 |
| 模型范围 | 全部模型 | 文本与多模态理解模型（拟定，生成类模型除外） |

两者可以同时使用：Key 相互独立，套餐额度用尽后自动回落到按量付费继续调用。

## 常见问题

### 余额不足会发生什么？

发起调用时返回 `402 insufficient_balance`，请求不会被转发到上游、不产生任何费用。充值后立即可用。建议开启[低余额提醒](#低余额提醒)避免业务中断。

### 支持哪些支付方式？

目前**仅支持微信支付**（PC 扫码 / 小程序），单笔 ¥1 ~ ¥10,000。

### 调用失败会扣费吗？

计费以返回的 `usage` 为准；视频等异步任务在生成失败时**自动退款**，Seedance 类任务在成功产出后才计费。

### 一个账户可以创建多少个 API Key？

没有数量限制。建议按项目 / 环境分别创建，便于成本归因；不再使用的 Key 请及时暂停或删除。

### 怎么查某个 Key 的消耗？

Portal「API Keys」页可看每个 Key 的用量；「调用流水」页可按 Key 与时间筛选逐笔记录，也可通过[管理与平台 API](/guide/management) 程序化拉取。

### 需要发票或对公结算怎么办？

当前 Portal 未提供自助开票，请联系平台支持处理。

## 相关文档

* [概述与快速接入](/guide/)：三种协议的调用示例
* [错误码参考](/guide/errors)：完整错误码与排查建议
* [管理与平台 API](/guide/management)：程序化查询账单与用量
* [组织用户使用指南](/platform/organization)：资金池与成员额度
* [订阅制套餐](/platform/subscription)：固定月费方案（即将上线）