跳转到主要内容

Gemini 图片编辑

POST /v1beta/models/{model}:generateContent
截至 2026 年 3 月 23 日,Crazyrouter 生产环境对 Gemini 原生图片编辑做了最小可复现实测,结果如下:
  • gemini-3.1-flash-image-preview 返回 500
  • gemini-2.5-flash-image-preview 返回 500
  • gemini-2.5-flash-image 返回 524
对应的 500 错误为:
  • code: "get_channel_failed"
  • message: 模型暂时不可用,请稍后重试
这意味着 Gemini 原生 generateContent 形态的“带输入图再编辑输出图”链路,目前不适合在 Crazyrouter 生产环境里作为稳定能力写成成功教程。
在重新验证成功之前,不要把 Gemini 原生图片编辑接入生产自动化流程。
如果你的目标是客户侧稳定接入图片编辑,而不是强依赖 Gemini 原生协议,当前请优先使用 Nano Banana family 的 POST /v1/images/generations 页面: Nano BananaNano Banana ProNano Banana 2。 这组公开协议当前都已经收紧为 image_input URL 输入。

当前建议

  1. 如果你的目标是 Gemini 文生图,优先参考 Gemini 图片生成
  2. 如果你的目标是客户侧稳定图片编辑,优先参考 Nano BananaNano Banana ProNano Banana 2
  3. 如果你必须评估 Gemini 原生图片编辑,请先用最小输入图做一次当日生产验证
  4. 如果请求返回 500 get_channel_failed524,先不要扩大流量,等待通道恢复后再试

Retest 模板

下面是本次用于复测的最小请求模板。它只表示“如何重测”,不代表当前已经稳定可用:
curl "https://crazyrouter.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Edit this image: change the background to blue and keep the main square visible. Return image output."},
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAA..."
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'