同步八位 PNG 与 b64 契约

记录八位 PNG 校验规则与稳定错误文案。说明 GPT-Image-2 原生 b64_json，不发送 response_format。
2026-09-11 17:52:26 +08:00
parent 4a32ee37c4
commit da19bde99a
1 changed files with 1 additions and 2 deletions
@@ -45,7 +45,6 @@ Raw 路由的 multipart body limit 为 `64 MiB`，覆盖图片和文本字段；
 ```text
 model = gpt-image-2
 n = 1
-response_format = b64_json
 ```

 请求不暴露 `model`、`n`、`response_format`、`style`、`user` 或 `output_compression`。
@@ -86,7 +85,7 @@ raw 操作使用独立的 operation / ledger 命名空间，例如 `raw-image-ed

 `platform-image` 保留 VectorEngine 协议细节。raw handler 只负责：认证、multipart 字段解析、PNG 预检查、计费编排和响应映射。provider 请求仍由 `platform-image` 统一构造，并携带 `model`、`n`、`quality`、`background`、`output_format`、尺寸及图片参考字节。

-provider 响应只提取并透传 `data[].b64_json` 字符串，不在服务端解码图片 base64，也不读取或回传 provider 的 `output_format`（该字段只是请求参数回显）。GPT-Image-2 的 provider 请求显式固定 `response_format=b64_json`，因此不实现 URL 响应下载或兼容分支。发送、响应读取、上游状态、响应解析和缺图失败必须生成 `PlatformImageFailureAudit`，由 api-server 写入现有外部 API 失败审计链；成功结果同时写入统一的 `external_generation_run` 追踪事件。raw handler 只将上游 `b64_json` 原样写入 `data[].b64_json`。
+provider 响应只提取并透传 `data[].b64_json` 字符串，不在服务端解码图片 base64，也不读取或回传 provider 的 `output_format`（该字段只是请求参数回显）。GPT-Image-2 原生只返回 `b64_json`，因此不发送 `response_format` 参数，也不实现 URL 响应下载或兼容分支。发送、响应读取、上游状态、响应解析和缺图失败必须生成 `PlatformImageFailureAudit`，由 api-server 写入现有外部 API 失败审计链；成功结果同时写入统一的 `external_generation_run` 追踪事件。raw handler 只将上游 `b64_json` 原样写入 `data[].b64_json`。

 ## 代码拆分