更新日志
改了什么,提前多久说
这里按日期倒序记 API 的变更。写作口径只有一条:照着这份日志和 OpenAPI 写代码的客户端,不该因为我们的改动而挂。
弃用策略
- 错误码只增不改。
code字段是机器契约:删掉一个 code、或者让同一个 code 表示另一种情况, 都算破坏性变更。error那句英文是可以随时改措辞的,别 match 它。 - 破坏性变更提前 90 天公告。 停用一个接口、改一个必填参数的含义、收紧一个上限—— 都会先写进这一页、标注生效日期,期间新旧两套并行。
- 弃用期内的响应会带
Sunset响应头(HTTP 日期),可以据此告警,不用天天刷这页。 - 加东西不算破坏性变更。 新增可选参数、新增响应字段、放宽上限,随时发生,靠 OpenAPI 与 llms.txt 同步——客户端请忽略不认识的字段。
- 价格不会在背后涨。 已买下的预付张数不受调价影响,永远不过期;调价只影响之后的购买。
-
2026-11-19
加固:幂等、限速、健康检查
- 新增
Idempotency-Key请求头:同一把 key 重发不扣额度、不建第二个任务, 重放响应带x-idempotent-replay: true。24 小时内有效。 - 新增每分钟上限(匿名 30、钥匙 120),超出回
429 rate_limited并带retry-after;不扣日额度。 - 新增
GET /api/status(机器)与 /status(人看):数据库、存储、 调度器心跳,健康200/ 降级503。 GET /v1/me现在匿名也能查(返回本 IP 的用量),并多了rate_limit_per_min和credits。- 修掉一处少退的账:请求已经回了
202之后才失败的任务,以前只改状态、 不退额度;现在失败一律退回——逐日额度退回扣的那一天,预付张数退回余额, 重放(Idempotency-Key)和网页上传的单也覆盖。done的单不退。 - 新增迁移落地页 /migrate/remove-bg:给从 remove.bg 过来的人一份 逐字段的接口映射、标明查询日期的价格对比,以及失败退款口径。
- 新增
-
2026-11-18
收敛成一个工具、一个域名
- 对外只留
POST /api/remove-background;其余 7 个能力(修脸/上色/放大/擦除/扩边/检测/文生图) 保持404 tool_paused,调用不扣额度。 - 破坏性变更(已过公告期):一次性接口的老别名
POST /v1/run与POST /api/run已下线,现在的路径是POST /api/{tool}。 - 域名统一到
photosweat.shop;photo.3dpea.com已停用。 - 预付价格定为 $0.01/张,$10 = 1000 张,账号页自助购买、Stripe 结算。
- 对外只留
-
2026-11-16
上线
POST /api/remove-background、GET /api/tools、GET /v1/me、GET /api/jobs/:id对外可用。- 匿名每天 10 张(按 IP)、注册后每天 30 张;输出尺寸与输入一致(长边超过 4096 px 先等比缩小)。
- MCP 端点
/mcp与 OpenAPI 3.1 同时上线,契约都从同一张能力表生成。
怎么第一时间知道
没有邮件列表。要机器化的做法:把 GET /api/status 挂进你的探针(降级是 503),
把 openapi.json 定期拉下来 diff;要人看的,收藏这一页。