# 生图模型参考图适配验收（2026-10-15）

本次平台适配、测试门禁、权限与异常处理验收通过。真实模型结果为两项通过、三项上游失败，失败型号没有获得开放资格；不能将本报告理解为所有型号都已可用。

## 实现范围

- 按上游正式目录的输入能力和 JSON Schema 识别参考图数组。明确声明图片输入、图生图能力且允许 Data URI 的接口，传入私有参考图；不按模型名字猜能力，不公开产品文件，不切换到其他路由重试。
- 支持 `gpt-image-2`、`gpt-image-2-vip`、`gpt-image-2.5`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst` 的原生 `images/generations` 参考图请求。复用已有图片归一化、结果解码和参考图验证。
- 仅文字输入的型号显示“仅支持文生图，不能接收产品参考图”。上游未提供参考图参数、上游停用、接口未适配分别给出原因。失败及未知结果直接显示安全诊断；展开详情不重复显示原因。
- 明确的上游终止拒绝记为失败；无法确认的 502、已受理任务及待核查状态继续暂停，保留请求编号，不自动重新调用。核查失败后保留核查说明，核查本身不会使模型通过。
- 目录同步增加可选 `modelKeys` 范围，服务端核对归属后只更新选中型号；现有全量同步仍可使用。目录同步不会自动启用、修改默认模型或插入测试通过记录。

## 真实模型验收

使用独立 QA 数据库、真实上游密钥和平台原生管理员测试接口。每型号只发起一次新请求，随机参考图颜色和位置由服务端校验；没有用模型自称支持或 HTTP 200 代替图片验证。

| 型号 | 真实结果 | 证据与处理 |
| --- | --- | --- |
| gpt-image-2 | 通过 | 请求 `b7ef37d7-34ca-41da-9dd0-ac2f02ee85ca`；1254×1254 图片可解码，两个色块颜色和相对位置匹配 |
| gpt-image-2-vip | 通过 | 请求 `11d3f051-fb61-48fd-b3b3-c1c672ec1774`；1254×1254 图片可解码，参考图验证通过 |
| gpt-image-2.5 | 未通过 | 请求 `e01ecf80-57b8-42a5-adfc-a8a88b6b66c7`；上游最终 `failed_final / 502 / service_rejected`，供应端 403 |
| gpt-image-2.5-flare | 未通过 | 请求 `34ee3b42-f86b-4714-aac6-e82a131d4d71`；同类上游终止拒绝，供应端 403 |
| gpt-image-2.5-sunburst | 未通过 | 请求 `46e4acad-d70a-498e-b29f-c5206ebbe92e`；同类上游终止拒绝，供应端 403 |

三个失败请求按本次幂等编号只读核查上游最终记录，再通过平台已有核查接口关闭未知状态，均保持失败和禁止开放。没有修改上游服务配置。供应端 403 的进一步原因不在本次平台证据中，不能推断为参考图格式错误。

`nano-banana-2-2k-cl`、`nano-banana-2-4k-cl` 仅声明文字输入，测试请求在服务端调用前拒绝，不消耗模型调用。其余型号继续以各自的正式能力和实际测试结果为准；没有宣称已完成全部上游型号的真实出图验收。

目录依据：[上游正式模型目录](https://api.vip98k.com/api/v2/catalog/models)（schema 2.2）及其 `format=skill` 调用说明。

## 验证结果

- 独立发布预览仅包含本次文件，基于 `88ce9e3798fb18accf002acb92f2fbc1fc8b9687`；未包含详情页知识库等其他在途修改，也没有数据库迁移或新依赖。
- 13 个相关测试套件、258 项测试通过；相关文件 ESLint 无错误；TypeScript 检查和本地生产构建通过。
- 原生 API 验证通过：五个原幂等请求重放没有新增执行；两个纯文生图型号调用前拒绝；三个失败型号启用被拒绝；通过型号可保存开放后恢复原配置，其他配置及默认值未变。
- 未登录返回 401；非超级管理员测试请求返回 403；以上负向操作没有新增测试记录或模型执行。
- 已检查 1440×1000 桌面与 390×844 手机实际页面。桌面内容宽/滚动宽均为 1425，手机均为 375，无横向溢出；通过用途能勾选，失败用途禁用；确认弹窗取消未调用模型；失败详情显示一次。

## Impeccable audit（Operate 模式，限定本次模型面板）

| 项目 | 分数 | 结果 |
| --- | --- | --- |
| 可访问性 | 3/4 | 状态可读，按钮和用途有名称、禁用原因；次要文字、错误、通过颜色对白底对比度分别为 4.69、6.57、6.09；未声称完成全站 WCAG 认证 |
| 性能 | 4/4 | 无新依赖、轮询或额外模型调用；沿用分页 |
| 响应式 | 4/4 | 桌面与手机实测，无横向溢出；测试和详情按钮高 44px |
| 主题一致性 | 3/4 | 保留现有管理面板颜色与布局，无无效 dark 变体；现有颜色常量未做全站迁移 |
| 实现完整性 | 4/4 | 具体原因来自服务端能力或真实记录；bundled detector 对目标组件无发现 |

总分 18/20。本范围无 P0/P1；原有管理页其他区块未纳入本次修改。原始验证记录、测试日志和桌面/手机截图在本地 `output/ai-image-adapter-20261015`。

## 发布约束

发布只提交本报告与对应适配、状态、测试文件。生产替换前校验原提交和镜像、执行队列门禁，保留上一镜像。上线后只刷新这五个型号的能力；不复制 QA 测试记录，不自动启用新模型，不改变现有默认模型。生产真实复测若仍失败，必须保持失败或待核查并保留原请求，不能为发布而伪造通过。