1

docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md

@@ -124,6 +124,8 @@ VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS=180000
 
 1. `拼图参考图解析完成` / `拼图参考图解析跳过`：确认前端是否传入参考图，以及 Data URL 解析或旧 `/generated-*` OSS 读取耗时；日志只记录 `reference_mime` 与 `reference_bytes`，不记录图片内容。
 2. `拼图 VectorEngine 图片生成 HTTP 返回`：VectorEngine `POST /v1/images/generations` 的同步上游耗时，若这一段长，慢点在 VectorEngine 生图接口。
-3. `拼图 VectorEngine 图片下载完成`：从 VectorEngine 返回的 `data[].url` 下载正式图耗时。
-4. `拼图生成图片已写入 OSS 与资产索引`：正式图上传 OSS、确认资产对象与实体绑定耗时。
-5. `拼图图片候选生成完成`：整段候选图生成总耗时。
+3. `拼图 VectorEngine 图片编辑 HTTP 返回`：有参考图且 AI 重绘时命中 `POST /v1/images/edits`。如果前端报 `创建拼图 VectorEngine 图片编辑任务失败：error sending request for url (...)` 且没有这条日志，说明请求在拿到 HTTP 响应前失败，先看响应 `details.reason/source/connect/body/timeout`，再查服务器 DNS、防火墙、代理或上游 multipart 连接中断。
+4. `拼图 VectorEngine 请求发送失败`：`reqwest` 在 `send()` 阶段失败时输出，包含 `connect`、`body`、`timeout` 和底层 `source`。拼图图片客户端强制 HTTP/1.1，以避开部分网关对 HTTP/2 multipart 的兼容问题。
+5. `拼图 VectorEngine 图片下载完成`：从 VectorEngine 返回的 `data[].url` 下载正式图耗时。
+6. `拼图生成图片已写入 OSS 与资产索引`：正式图上传 OSS、确认资产对象与实体绑定耗时。
+7. `拼图图片候选生成完成`：整段候选图生成总耗时。