docs: 新增 OpenAI gpt-image-2 取证页,并修火山页三处过期状态
CI / docs-build (push) Successful in 33s

取证页记录从两份官方文档实际读到的事实:两个端点、参数取舍、尺寸四条算术规则、
响应字段映射、错误映射、同步接口的两笔代价。

两处如实标注的不确定性:
- 尺寸上限「3840x2160」文档未说清逐边还是按像素,本页写明采用的读法与理由
  (逐边理解会禁掉所有高于 2160 的竖图,而 1024x1536 是文档明示的标准竖图)。
- 两份文档都没有错误码表,故错误映射按状态码为主推断,整节挂 ⚠️ 未经证实,
  并写明拿到真实错误数据后的校正路径。

火山页三处已过期的状态:图片适配层已落地(但产物转存仍阻塞,故仍不播种模型)、
HTTP 端点已实现、Java 侧 provider 适配已实现。

mkdocs build --strict 通过。
This commit is contained in:
2026-09-21 12:10:20 +08:00
parent 8cf8ba41c9
commit de4e02f805
3 changed files with 254 additions and 5 deletions
@@ -214,9 +214,10 @@
类且其 `preview_asset_id` 指向 demo 资产,而 V1..V7 链路不含该 demo 种子,照抄
会违反外键。`generation_jobs.style_id` 可空,故空风格表不阻塞任何功能。
**图片模型同样未播种**:gpt-image-2 的适配层尚未落地,播种一个没有适配器的模型
会让客户端渲染出一个点了没反应的入口(目录端点按 `media_kind` 聚合可用模型,
故当前只返回 `video`)。
**图片模型同样未播种**:gpt-image-2 的适配层已落地(见
[OpenAI gpt-image-2](openai-gpt-image.md)),但**产物转存仍阻塞于存储决策**,
故仍不播种——播种一个拿不到产物的模型会让客户端渲染出一个点了没反应的入口
(目录端点按 `media_kind` 聚合可用模型,故当前只返回 `video`)。
## 6. 实现状态
@@ -232,8 +233,8 @@
| 模型限制预校验(`providers/volcengine/capabilities.py`) | ✅ 23 测试 |
| V7 目录种子(两个已开通模型) | ✅ 6 测试(含 `provider_code` 跨语言一致性) |
| 产物转存 | ⏸ 阻塞于存储决策(ADR-023 §7)。注意 §2-④ 的 24 小时硬约束 |
| HTTP 端点与 `openapi-internal.yaml` | ⏸ 未开始 |
| Java 侧 provider 适配 | ⏸ 待上一项落地 |
| HTTP 端点与 `openapi-internal.yaml` | ✅ 提交/查询 + 服务身份 JWT 校验 |
| Java 侧 provider 适配 | ✅ `patbond-creation` 的 `provider/ai/`(Feign + snake_case) |
**一处跨语言约定,两侧都有测试钉住**:目录表的 `provider_code` 必须与
`patbond-ai` 适配器的 `PROVIDER_CODE` **逐字一致**(`volcengine-seedance`)。