feat(ai): enforce direct image edit contract

2026-07-20 17:52:59 +08:00
parent 61db0f4ed6
commit 2a2cbad7bd
11 changed files with 382 additions and 94 deletions
@@ -15,6 +15,7 @@
 > **v3.6 修订（2026-07-08，T-564）**：cmhub 已新增异步生图任务接口，②批量生图改为 `POST /api/v1/generate/image/tasks` submit + `GET /api/v1/generate/image/tasks/{task_id}` poll；cmshopee 持久化 `tasks.image_task_id/image_task_key`，支持停止/超时/重启后续查，避免 900 秒同步长连接和读超时重复扣点。旧同步 `POST /api/v1/generate/image` 仅保留给单独 `gen_cover()` 兼容/回滚路径。
 > **v3.7 修订（2026-07-17，T-645）**：⑥「商品套图」的 AI帮写接入独立图片理解能力：使用 `vision_alias` 调 `POST /api/v1/analyze/images`，不复用标题接口或 `title_alias`。请求最多8张有序本地原图，单图不超过10MiB、总计不超过32MiB；读取等待120秒且读超时不自动重发，避免结果未确认时重复扣点。
 > **v3.8 修订（2026-07-20，T-677）**：T-529 的普通 UI 单来源收口有限放开为「默认网关 / 自定义网关」分段选择器，来源仅在保存设置后切换。自定义网关是客户端直连的过渡兼容路径，只覆盖②生文、生图；模型清单与默认网关配置并存。⑥商品套图和图片理解仍只允许默认网关新建请求，但此前已由默认网关接受、且同时带 `generation_source=cmhub`、`provider=cmhub` 与 `task_id` 的套图 job 可继续轮询、下载、保存，避免已扣点结果丢失。运行中的 worker 冻结来源、模型与密钥的内存快照，后续保存设置不影响本轮；密钥不写入 SQLite、日志或 UI。
+> **v3.9 修订（2026-07-20，T-678）**：自定义网关的图片生成固定采用 OpenAI 图片编辑契约：`POST /v1/images/edits`、multipart 有序重复 `image[]`、第一张为业务主体图、`n=1`，仅从 `data[].b64_json` 或 `data[].url` 读取结果。`category=image` 只有 `api_type=images_edits` 可发起生成；历史 `chat` / `auto` 图片模型保留可查看但在设置和生成预检中明确为不支持，绝不静默迁移。默认网关的 cmhub 请求、异步任务与宽松响应解析不受该收敛影响。⑤对图片模型只做本地配置检查，不发送可能计费的空图片请求；实际可用性通过②或后续⑥的正常生成确认验证。

 ## 1. 背景与目标