跳转到主要内容

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.

​
Gemini 图片生成

POST /v1/images/generations
Crazyrouter 对 Gemini 图片模型统一提供 OpenAI Images 兼容入口。用户侧不需要直接调用 Gemini 原生 generateContent，也不需要传 Gemini 原生 generationConfig.imageConfig。
推荐公开模型名兼容底层模型名
nano-banananano-banana
nano-banana-pronano-banana-pro
nano-banana-2nano-banana-2
Gemini 图片生成属于长耗时请求。生产接入请优先使用主承接线路 https://cn.crazyrouter.com/v1，完整生成端点为 https://cn.crazyrouter.com/v1/images/generations。
推荐在客户代码里使用 nano-banana、nano-banana-pro、nano-banana-2。如果你的系统已经直接写了 nano-banana、nano-banana-pro、nano-banana-2，也可以继续通过同一个 Images API 入口调用。

​
请求参数

参数类型必填说明
modelstring是nano-banana、nano-banana-pro、nano-banana-2，或对应 Gemini canonical 名
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
不要传这些上游私有字段：generationConfig、imageConfig、imageOutputOptions、image_output_options。

​
请求示例

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-2",
    "prompt": "A simple red square on a white background, clean vector style",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }'
响应保持 OpenAI Images 风格： 
{
  "created": 1778990000,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/05/17/sync-image/request-id-1.png"
    }
  ]
}

​
参考图编辑

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-pro",
    "prompt": "把参考图改成高级电商海报，保留主体，背景更简洁",
    "image_input": [
      "https://example.com/reference.png"
    ],
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'
如果你确实需要 Gemini 原生 API 形态，请参考 Gemini 原生格式。但对于图片生成和编辑，推荐客户侧统一使用本页的 Images API。