接入说明

所有业务接口使用 Authorization: Bearer <业务密钥>。

创建任务

POST /v1/generations，multipart/form-data：

• reference_image：首图参考图文件（JPEG/PNG/WebP）
• product_collage_image：本地已合并且带 Pic1–Pic5 标记的五图文件
• product_title：商品标题，最多1000字符
• options：JSON字符串，必须包含 output_positions，例如 {"output_positions":["1:1_0","1:1_2"]}

每张上传图最多15MiB、1000万像素。无须商品ID。坑位1:1_0到1:1_4依次代表商品主图1至5。默认加卖点，主图1使用视觉参考。

可选 Idempotency-Key 请求头用于业务重试：同一密钥与相同输入复用原任务；不同输入返回409。

返回202及 task_id、status_url、output_positions。GET /v1/generations/{task_id} 查询状态和 images，每个成功坑位包含 url 与 sha256。

终态：succeeded 全部成功；partial 部分成功；failed 失败；needs_reconciliation 有提交结果不明，禁止自动重新提交。

链接有效24小时，可重新查询任务获取新链接；图片保留7天。规划只调用一次（技术失败另有重试），参考图按内容哈希缓存，不做额外模型审核。