积分与速率限制
生成会从统一钱包中扣除积分。任务开始时扣除，失败时自动退款。
费用取决于所选的引擎和选项：一张图像因模型不同为 15 到 200 积分不等（2K/4K 输出更高），因此决定一个批次成本的通常是模型选择，而非请求数量。每个模型精确、权威的数值是 GET /v1/models 的 cost（和 textureCost）字段；当前余额可通过 GET /v1/credits 查询。
费用
| 操作 | 典型费用 |
|---|---|
| 图像生成 | ≈ 15–200 积分（因模型而异） |
| 文本 / 图像 → 3D | ≈ 60–660 积分（因引擎和选项而异）— 默认（PB Slim + 贴图；除非发送 texture: false，/v1 默认开启贴图）为文本 240 · 图像 300 |
| 重构网格 | 10 积分起（PB Remesh） |
| 重新贴图 · 自动绑定 | 因引擎而异，参见 GET /v1/models |
积分折合美元
套餐每月发放积分，年付套餐也一样（未用完的套餐积分不会结转），付费套餐还可以购买积分包追加。每 1,000 积分的价格如下：
| 积分来源 | 价格 | 每 1,000 积分 |
|---|---|---|
| Max · 月付 | $96 / 100,000 | $0.96 |
| Pro · 月付 | $32 / 30,000 | $1.07 |
| Starter · 月付 | $12 / 10,000 | $1.20 |
| 积分包 · 付费套餐 | $14.99 / 6,000 至 $499.99 / 300,000 | $1.67–$2.50 |
默认的图像 → 3D 任务（PB Slim + 贴图，300 积分）在 Max 上约 $0.29，在 Starter 上约 $0.36。年付套餐的每积分价格更低。最新价格始终以定价页面为准。
taskStatus: 3 结束的任务不产生任何费用。速率限制
| 限制 | 范围 | 超出时 |
|---|---|---|
| 240 / 分钟 | 每个客户端 IP | 429 · error.code 10003 |
| 120 / 分钟 | 每个用户（生成类 POST） |
超出限制会返回 429 并带有 error.code 10003。请以指数退避方式增加延迟（从 ~1 秒开始，上限 ~30 秒）后重试。需要更高的限制以应对生产环境的用量？联系我们。
每个密钥的每日安全上限
同一个 API 密钥在一天内（KST）发起的生成累计达到 20,000 积分时，该密钥会被自动暂停，以防密钥泄露时积分被一次性耗尽。暂停期间只能查询和下载（已开始任务的结果仍可取回），其余请求都会返回 403（error.code 6016）。账号所有者会收到通知邮件，并可在 API Keys 页面恢复该密钥。每次恢复后，当天还可再使用 20,000 积分，超过后会再次暂停。如果这些用量不是你本人产生的，请不要恢复，直接删除该密钥并创建新密钥。
并发生成
除每分钟请求速率外，账号还会限制同时进行的任务数量，即处于 taskStatus 0（排队中）或 1（处理中）状态的任务。图像和 3D 任务使用各自独立的额度，每种额度都与使用同一账号登录的 PicoBerry 网页应用共享。
| 套餐 | 同时进行的图像 | 同时进行的 3D 与后处理 |
|---|---|---|
| Free | 1 | 1 |
| Starter | 3 | 5 |
| Pro | 6 | 20 |
| Max | 15 | 30 |
超过上限提交会返回 429 并带有 error.code 13002。不会扣费，也不会排队，请求会被直接拒绝，因此有空位时重试即可。
{ "success": false, "error": { "code": 13002, "message": "Generation queue is full", "httpStatus": 429, "details": { "total": 15, "maxTotal": 15 } } }details.maxTotal 是当前上限，details.total 是当前进行中的数量。请读取 maxTotal 而不要硬编码数字，它代表完整的额度，升级后会提高，而猜测偏低的客户端会白白浪费吞吐量。常见的做法是：保持 maxTotal 个请求在运行，每当有任务到达 taskStatus 2 或 3 时再启动一个。