📚 API 文档目录
所有端点统一走 HTTPS + JSON。基础地址：https://api.aifengdcs.com（演示环境，SIM）。
🔐 鉴权与签名
每次请求携带 X-App-Key 头，并用 AppSecret 对「时间戳 + 请求体」做 HMAC-SHA256 签名，放入 X-Sign 头；签名有效期 5 分钟。
⚠️ 错误码
401 签名无效 / 403 密钥未获批或已停用 / 409 幂等键冲突 / 429 超出限流 / 460 豆余额不足 / 500 服务异常（可重试）。
🚦 限流规则
默认每密钥 60 次/分钟；异步任务并发上限 5 个；免费额度用完后按豆价扣费，余额不足返回 460。
📞 回调协议
回调为 POST JSON，携带 X-Sign 头（与请求签名同规则），你的服务需在 10 秒内返回 200，否则视为失败并重推。
端点列表
🛰️ 采集API
POST /openapi/v1/collect/products
按关键词或店铺链接批量采集商品标题、主图与规格，返回结构化 JSON，可直接进入套图流水线。
🫘 2 豆/次 · 每日免费 50 次
✂️ 提取API
POST /openapi/v1/extract/design
从商品主图中提取透明底图案层，输出 PNG 透明通道与设计元素坐标，供二次排版复用。
🫘 3 豆/次 · 每日免费 30 次
🎨 文生图API
POST /openapi/v1/images/generate
输入三语提示词生成原创印花图案，支持尺寸与风格参数；结果为模拟生成（SIM），用于流程验证。
🫘 10 豆/次 · 每日免费 10 次
🖼️ 抠图API
POST /openapi/v1/images/matting
人像/商品一键去背，返回透明 PNG 与边缘羽化参数，支持批量任务异步回调。
🫘 4 豆/次 · 每日免费 20 次
👕 套图API
POST /openapi/v1/mockups/render
把图案批量套入 T 恤、马克杯、手机壳等产品模板，一次生成多产品效果图与详情图组。
🫘 6 豆/次 · 每日免费 15 次
🚀 上架API
POST /openapi/v1/listings/push
把套图成品组装为商品草稿推送到商城待审区；正式上架一律 Human-Gate 待批，绝不自动发布。
🫘 2 豆/次 · 每日免费 20 次
🛡️ 侵权检测API
POST /openapi/v1/ipcheck/scan
对图案做商标/版权相似度扫描（模拟结果 + SIM 标识），输出风险等级与命中样例，降低上架侵权风险。
🫘 5 豆/次 · 每日免费 25 次