跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Nano Banana

POST /v1/images/generations
nano-banana 是 nano-banana 的公开别名。用户侧统一使用 OpenAI Images 兼容协议；Gemini / Vertex 原生承载、字段转换和路由选择都由 Crazyrouter 在服务端处理。
图片生成、图片编辑、多参考图这类请求通常耗时较长。生产接入请优先使用主承接线路 https://cn.crazyrouter.com/v1，完整生成端点为 https://cn.crazyrouter.com/v1/images/generations。账号登录、充值和控制台仍使用 https://crazyrouter.com。

​
模型名

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

​
请求参数

参数类型必填说明
modelstring是推荐 nano-banana；也兼容 nano-banana
promptstring是生成或编辑指令
image_inputstring 或 string[]否参考图 URL；不传则为文生图
resolutionstring否1K、2K、4K
aspect_ratiostring否如 1:1、16:9、9:16、21:9、auto
output_formatstring否png、jpeg / jpg
output_compressioninteger否0-100，用于 JPEG 压缩质量
ninteger否生成数量，默认 1
不要在客户请求里传 Gemini 原生字段，例如 generationConfig、imageConfig、imageOutputOptions、image_output_options。这些属于上游 provider 细节，Crazyrouter 会从统一参数自动转换。

​
文生图示例

curl -X POST https://cn.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana",
    "prompt": "A clean banana icon on a white background, minimal product style",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }'

​
参考图编辑示例

cURL
curl -X POST https://cn.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana",
    "prompt": "保持主体不变，把背景改成白色电商棚拍风格",
    "image_input": [
      "https://example.com/product.png"
    ],
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'

​
响应

响应保持 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"
    }
  ]
}

​
常见错误

错误写法正确写法
直接调用 /v1beta/models/nano-banana:generateContent改用 POST /v1/images/generations
在请求中传 image_output_options改用统一参数 output_format、output_compression
只把 base URL 配成 https://cn.crazyrouter.com 后又让 SDK 拼 OpenAI 路径OpenAI SDK 使用 https://cn.crazyrouter.com/v1