图片血汗工厂

更新日志

改了什么,提前多久说

这里按日期倒序记 API 的变更。写作口径只有一条:照着这份日志和 OpenAPI 写代码的客户端,不该因为我们的改动而挂。

弃用策略

  1. 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 过来的人一份 逐字段的接口映射、标明查询日期的价格对比,以及失败退款口径。
  2. 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 结算。
  3. 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;要人看的,收藏这一页。