积分与速率限制
生成会从统一钱包中扣除积分。任务开始时扣除,失败时自动退款。
费用取决于所选的引擎和选项:一张图像因模型不同为 15 到 200 积分不等(2K/4K 输出更高),因此决定一个批次成本的通常是模型选择,而非请求数量。每个模型精确、权威的数值是 GET /v1/models 的 cost(和 textureCost)字段;当前余额可通过 GET /v1/credits 查询。
费用
| 操作 | 典型费用 |
|---|---|
| 图像生成 | ≈ 15–200 积分(因模型而异) |
| 文本 / 图像 → 3D | ≈ 60–80 积分 |
| 重构网格 | 10 积分起(PB Remesh) |
| 重新贴图 · 自动绑定 | 因引擎而异,参见 GET /v1/models |
仅对成功的任务计费 积分在任务开始时扣除,失败时自动退款。以
taskStatus: 3 结束的任务不产生任何费用。速率限制
| 限制 | 范围 | 超出时 |
|---|---|---|
| 240 / 分钟 | 每个客户端 IP | 429 · error.code 10003 |
| 120 / 分钟 | 每个用户(生成类 POST) |
超出限制会返回 429 并带有 error.code 10003。请以指数退避方式增加延迟(从 ~1 秒开始,上限 ~30 秒)后重试。需要更高的限制以应对生产环境的用量?联系我们。
并发生成
除每分钟请求速率外,账号还会限制同时进行的任务数量,即处于 taskStatus 0(排队中)或 1(处理中)状态的任务。图像和 3D 任务使用各自独立的额度,每种额度都与使用同一账号登录的 PicoBerry 网页应用共享。
| 套餐 | 同时进行的图像 | 同时进行的 3D 与后处理 |
|---|---|---|
| Free | 1 | 1 |
| Starter | 3 | 5 |
| Pro | 6 | 20 |
| Max | 15 | 30 |
超过上限提交会返回 429 并带有 error.code 13002。不会扣费,也不会排队,请求会被直接拒绝,因此有空位时重试即可。
429 · 队列已满
{ "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 时再启动一个。