Nano Banana 报错排查

参数取值见 Nano Banana 文生图与尺寸。

先按现象找

400 Request contains an invalid argument

{
  "error": {
    "code": 400,
    "message": "Request contains an invalid argument.",
    "status": "INVALID_ARGUMENT"
  }
}

该报错不会指明具体参数。实测以下情况均返回此错误：

排查方法：先移除 imageConfig 重试；若可正常生成，说明问题出在比例或分辨率，再逐项加回定位。

比例或分辨率不符

请先检查输出图片的实际宽高，再对照下表排查：

正确写法：

{
  "contents": [{ "parts": [{ "text": "..." }] }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": { "aspectRatio": "9:16", "imageSize": "2K" }
  }
}

imageConfig / image_config、aspectRatio / aspect_ratio 两种写法均可识别，实测 image_config: { aspect_ratio: "9:16" } 正确输出 768×1376。

响应中没有图片

在 Cherry Studio、LobeHub 等客户端中使用时，请将其添加为图像生成模型，而非聊天模型。

410 model_deprecated

{
  "error": {
    "message": "Model 'google/gemini-3-pro-image-preview' is deprecated and no longer accepts requests; please switch to an active model",
    "type": "model_deprecated",
    "code": 410
  }
}

以 -preview 结尾的旧 ID 已下线，请改用正式版 ID：

原生接口路径中的模型 ID 可带 google/ 前缀，也可省略，实测均可正常调用。

改图结果与原图无关

确认参考图已被读取：原生接口查看 usageMetadata.promptTokensDetails 中是否包含 IMAGE 项；OpenAI 兼容接口查看 usage.input_tokens_details.image_tokens。实测一张 1024×1024 的参考图计 1,120 个 token。

安全拦截

请求被安全策略拦截时，响应中不含图片，原因记录在 finishReason 或 promptFeedback.blockReason 中。各取值的含义（依据 Google 官方定义）：

代码中不应假定响应必然包含图片：应先检查 candidates 是否存在、finishReason 是否为 STOP，再读取 inlineData。各字段定义见 Gemini API · FinishReason 。

超时、504、524

接口为同步调用，实测 1K 约 5 至 20 秒，4K 约 30 秒，高峰期耗时更长。常见的 60 秒默认超时无法覆盖。

• 客户端超时设为 300 秒以上。
• 检查 Nginx、Vercel、Cloudflare 等中间代理的超时设置，其默认值通常仅为 60 至 100 秒。
• 4K 的 PNG 约 16 MB，响应体超过 20 MB，请确认代理不会截断大体积响应。

客户端提前断开时，请求仍会计费。

其他报错

联系技术支持时，请提供响应中的 request_id 及完整报错信息。

常见问题