更新日期：2026-09-18

需要提交后立即返回、稍后轮询取图片 URL？该模型支持异步生图：Gemini 系把路径后缀换成 :asyncGenerateContent，OpenAI 系加 Prefer: respond-async 头，请求体一个字节都不用改。

Nano Banana 2

POST /v1/images/generations

nano-banana-2 是 nano-banana-2 的公开别名。用户侧统一使用 OpenAI Images 兼容协议；服务端会把 output_format、output_compression、resolution、aspect_ratio 等统一参数转换成 Gemini / Vertex 原生请求。

nano-banana-2 属于长耗时图片模型。生产接入请优先使用主承接线路 https://api.crazyrouter.com/v1，完整生成端点为 https://api.crazyrouter.com/v1/images/generations。账号登录、充值和控制台仍使用 https://crazyrouter.com。

模型名

推荐模型名	等价底层模型
`nano-banana-2`	`nano-banana-2`

推荐在客户代码里使用 nano-banana-2。如果你的系统已经直接写了 nano-banana-2，也可以继续通过同一个 /v1/images/generations 入口调用。

请求参数

参数	类型	必填	说明
`model`	string	是	推荐 `nano-banana-2`；也兼容 `nano-banana-2`
`prompt`	string	是	生成或编辑指令
`image_input`	string 或 string[]	否	参考图 URL；不传则为文生图
`resolution`	string	否	`1K`、`2K`、`4K`
`aspect_ratio`	string	否	如 `1:1`、`16:9`、`9:16`、`21:9`、`auto`
`output_format`	string	否	`png`、`jpeg` / `jpg`
`output_compression`	integer	否	`0-100`，用于 JPEG 压缩质量
`n`	integer	否	生成数量，默认 `1`

不要在客户请求里传 Gemini 原生字段，例如 generationConfig、imageConfig、imageOutputOptions、image_output_options。这些字段由 Crazyrouter 在服务端按当前上游协议自动生成。

文生图示例

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A clean ecommerce hero shot of a red apple on a white background",
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
    "output_compression": 85
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.crazyrouter.com/v1",
)

response = client.images.generate(
    model="nano-banana-2",
    prompt="A clean ecommerce hero shot of a red apple on a white background",
    n=1,
    extra_body={
        "resolution": "1K",
        "aspect_ratio": "16:9",
        "output_format": "jpeg",
        "output_compression": 85,
    },
)

print(response.data[0].url or response.data[0].b64_json)

参考图编辑示例

cURL

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "把参考图改成横幅广告图，保留主体，背景更干净",
    "image_input": [
      "https://example.com/reference.png"
    ],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }'

响应

响应保持 OpenAI Images 风格。默认优先读取 data[0].url；少数兼容渠道可能返回 data[0].b64_json。

{
  "created": 1778990000,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/05/17/sync-image/request-id-1.png"
    }
  ]
}

迁移说明

旧代码如果直接调用：

POST /v1beta/models/nano-banana-2:generateContent

建议迁移到：

POST https://api.crazyrouter.com/v1/images/generations

并把 Gemini 原生参数改成统一参数：

Gemini 原生概念	Crazyrouter 统一参数
`imageConfig.aspectRatio`	`aspect_ratio`
`imageConfig.imageSize`	`resolution`
`imageOutputOptions.mimeType`	`output_format`
`imageOutputOptions.compressionQuality`	`output_compression`

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

图像生成

视频生成

音频

嵌入 & 重排序

其他 API

参考

Nano Banana 2

Nano Banana 2

模型名

请求参数

文生图示例

参考图编辑示例

响应

迁移说明

相关页面

​Nano Banana 2

​模型名

​请求参数

​文生图示例

​参考图编辑示例

​响应

​迁移说明

​相关页面

Nano Banana 2

模型名

请求参数

文生图示例

参考图编辑示例

响应

迁移说明

相关页面