Nano Banana 2 API 422 参数校验排查
编辑部 发布 2026-08-29 最后更新 2026-08-29
Nano Banana 2 API 的 422 validation_error 要先读取 details 并修正字段，不能原样重试。重点核对 model、mode、prompt、固定 count=1，以及编辑模式所需的公开 HTTPS image_urls。
Nano Banana 2 API 返回 422 validation_error 时，应把 details 当作修正依据，而不是继续原样重试。接口基址只有 https://open-api.flux-art.cn/openapi/v1；未公开枚举以官网与控制台当前说明为准。
哪些字段需要优先核对
| 字段 | 核对重点 |
|---|---|
model | 使用 GET /models 当前返回的有效模型 ID |
mode | 只能按接口要求使用 generate 或 edit |
prompt | 至少 3 个非空白字符 |
count | 固定为 1 |
image_urls | 编辑或参考模式必填，且为公开 HTTPS URL |
size、aspect_ratio | 按当前模型支持范围填写 |
图片地址问题可查看媒体 URL 要求，尺寸与比例边界见参数说明。
修正后是否沿用原幂等键
参数已经改变，就应把修正后的提交视为新请求并使用新幂等键。原样参数因瞬时 5xx 重试才沿用原键；两种情况不要混用。
关于「Nano Banana 2 API 422 参数校验排查」的常见问题
- 422 适合自动重试吗?
- 不适合原样重试。应根据 details 修正字段后，把它作为新请求提交。
- 编辑模式最容易漏什么?
- mode=edit 时需要符合要求的公开 HTTPS image_urls，并应核对素材能否访问。
- size 的具体枚举能写死吗?
- 不能。未公开的枚举以官网和控制台当前说明为准。