快速开始

积分与速率限制

生成会从统一钱包中扣除积分。任务开始时扣除,失败时自动退款。

费用取决于所选的引擎和选项:一张图像因模型不同为 15200 积分不等(2K/4K 输出更高),因此决定一个批次成本的通常是模型选择,而非请求数量。每个模型精确、权威的数值是 GET /v1/modelscost(和 textureCost)字段;当前余额可通过 GET /v1/credits 查询。

费用

操作典型费用
图像生成≈ 15–200 积分(因模型而异)
文本 / 图像 → 3D≈ 60–80 积分
重构网格10 积分起(PB Remesh)
重新贴图 · 自动绑定因引擎而异,参见 GET /v1/models
仅对成功的任务计费 积分在任务开始时扣除,失败时自动退款。以 taskStatus: 3 结束的任务不产生任何费用。

速率限制

限制范围超出时
240 / 分钟每个客户端 IP429 · error.code 10003
120 / 分钟每个用户(生成类 POST)

超出限制会返回 429 并带有 error.code 10003。请以指数退避方式增加延迟(从 ~1 秒开始,上限 ~30 秒)后重试。需要更高的限制以应对生产环境的用量?联系我们

并发生成

除每分钟请求速率外,账号还会限制同时进行的任务数量,即处于 taskStatus 0(排队中)或 1(处理中)状态的任务。图像和 3D 任务使用各自独立的额度,每种额度都与使用同一账号登录的 PicoBerry 网页应用共享。

套餐同时进行的图像同时进行的 3D 与后处理
Free11
Starter35
Pro620
Max1530

超过上限提交会返回 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 23 时再启动一个。