fix(openapi): 补回图片异步响应契约 #26

2026-07-22T15:44:06+08:00

easyai commented

2026-07-22 15:44:06 +08:00

问题

并行合并的官方兼容响应协议重写了 Images OpenAPI 注解，但遗漏了运行时已支持且集成测试覆盖的异步 202 响应，导致桌面端重新生成客户端后 typecheck 失败。

修复

为 Images 生成与编辑接口声明 X-Async 请求头
为两个接口补回 202 TaskAcceptedResponse
重新生成 swagger.json 与 swagger.yaml

验证

pnpm openapi 通过
go test ./internal/httpapi 通过
staged diff 凭据值扫描命中为 0
桌面端生成客户端可恢复异步响应类型

## 问题并行合并的官方兼容响应协议重写了 Images OpenAPI 注解，但遗漏了运行时已支持且集成测试覆盖的异步 202 响应，导致桌面端重新生成客户端后 typecheck 失败。 ## 修复 - 为 Images 生成与编辑接口声明 X-Async 请求头 - 为两个接口补回 202 TaskAcceptedResponse - 重新生成 swagger.json 与 swagger.yaml ## 验证 - pnpm openapi 通过 - go test ./internal/httpapi 通过 - staged diff 凭据值扫描命中为 0 - 桌面端生成客户端可恢复异步响应类型

easyai added 1 commit 2026-07-22 15:44:13 +08:00

fix(openapi): 补回图片异步响应契约 2812cadd4f

为 Images 生成与编辑接口重新声明 X-Async 参数和 202 TaskAcceptedResponse，保持 OpenAPI 与真实运行时行为一致。

已重新生成 Swagger，并通过 HTTP API 测试和桌面端生成客户端类型检查验证。

easyai merged commit fbe8d1d3ec into main

2026-07-22 15:44:59 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: BCAI/easyai-ai-gateway#26