# 套餐、账单与限制

在 Zyla API Hub 上有两种付费方式。选一种适合你的用法就行，同一个账户也可以两种都用。

## 两种付费方式

| | 按次付费 | 月度套餐 |
|---|---|---|
| **适合谁** | AI 代理，以及偶尔用一下的场景 | 自己的程序持续、稳定地调用某个 API |
| **怎么运作** | 你的代理通过 [Zyla MCP 服务器](https://zylalabs.com/zh/docs/mcp) 调用任意 API。每次成功的调用都会按该 API 的单次调用价格计费 | 你在该 API 的页面订阅一个套餐：固定价格对应每月一定的调用次数 |
| **订阅** | 不需要订阅，只为成功的调用付费 | 每个 API 一份订阅，自动续订，直到你取消 |
| **你需要** | 绑定一张信用卡 | 为你用到的每个 API 订阅一个套餐 |

**按次付费。** 没有月费，也没有最低消费。如果没有绑定信用卡，你的代理会收到一个付款链接（`402`），打开它添加卡就行。你可以让代理告诉你*账户状态*，看看这个周期已经花了多少钱。

**月度套餐。** 每个 API 都有自己的套餐，由其提供商设置：价格、每月调用次数和每分钟请求限制。部分 API 提供少量调用次数的免费试用。你可以随时在该 API 页面升级、降级或取消套餐；套餐会在每个周期结束时自动续订，直到你取消为止。发票和付款方式在账户菜单的 **Billing** 里。退款遵循 [退款政策](https://zylalabs.com/zh/refund)。

## 限制

- **每分钟请求数。** 每个套餐允许每分钟 60、120 或 240 次请求。超过这个数量，请求会被拒绝，直到下一分钟开始。
- **每月调用次数。** 用完套餐里的调用次数后，请求会被拒绝，直到你升级套餐或进入下一个周期。
- **未付发票。** 如果一张发票 72 小时内一直未支付，订阅会被暂停，直到你在账单门户完成支付。

开发者可以通过响应头跟踪用量；详见 [通过 HTTP 调用 API](https://zylalabs.com/zh/docs/calling-apis)。

## 出错时

Hub 返回的错误会带有一个 `message` 字段，说明发生了什么：

| 状态码 | 代表什么 | 怎么处理 |
|---|---|---|
| `401` | 密钥缺失或错误、未订阅该 API、HTTP 方法错误，或赠送试用已过期 | 检查密钥和订阅状态；代理会自动完成订阅 |
| `402` | 没有绑定信用卡（代理按次付费的场景） | 打开付款链接并添加一张卡 |
| `403` | 账户被封禁，或该密钥被限制为只能访问其他 API | 换一个被允许访问该 API 的密钥 |
| `404` | 该 API 或端点不存在，或未公开 | 检查 API 和端点是否正确 |
| `410` | 该端点已下线 | 使用该 API 页面上列出的替代端点 |
| `422` | 某个参数的类型或格式不正确 | 按照 message 中提到的参数名修正 |
| `429` | 每分钟请求过多、套餐或试用调用次数用完，或订阅被暂停 | 稍等一下、升级套餐，或支付未结清的发票 |

其他任何状态码（例如服务提供商自己返回的 `400` 或 `500`，并附带其自身的提示信息）都来自该 API 本身。如果问题一直存在，请联系我们的团队，并附上 API 名称和调用时间。


---
Source: https://zylalabs.com/zh/docs/plans-and-limits