Nano Banana 同步图像生成

Gemini 图像模型(nano-banana 系列)可以直接通过 OpenAI 官方生图端点 POST /v1/images/generations 同步调用:请求与响应均为标准 OpenAI Images API 格式,OpenAI SDK 与各类生图客户端无需任何适配即可使用。

- 同步模式:请求阻塞至出图完成,响应直接返回图像数据,无需轮询任务。 - response_format 默认 b64_json(Base64);指定 url 时返回网关托管的图像链接,请及时保存。 - 支持文生图、图生图与图像编辑(参考图);该系列模型单次仅生成 1 张图,按实际生成张数计费。 - 支持 OpenAI 兼容编辑端点 POST /v1/images/edits,通过 multipart/form-data 上传 image 或 image[] 文件。

鉴权#

所有接口均需通过 Bearer Token 认证。请在 API Key 管理页面 创建你的 Key,并在请求头中添加:

Authorization: Bearer YOUR_API_KEY

调用端点#

• 文生图与 JSON 参考图: POST /v1/images/generations
• OpenAI 兼容 multipart 图像编辑: POST /v1/images/edits

支持模型#

请求参数#

size 映射#

也可直接传 W:H 格式(如 4:3)透传给上游;其他自定义尺寸不下发宽高比,由上游默认处理。

quality 映射#

不同档位价格不同,详见模型价格页。

请求示例#

最简文生图:

{
  "model": "nano-banana-2",
  "prompt": "一只猫在草地上玩耍"
}

图生图 / 图像编辑:

curl https://api.apimax.ai/v1/images/generations   --header 'Authorization: Bearer YOUR_API_KEY'   --header 'Content-Type: application/json'   --data '{
    "model": "nano-banana-2",
    "prompt": "把背景换成海边日落",
    "image_urls": ["https://example.com/photo.png"],
    "aspect_ratio": "3:2",
    "quality": "4K"
  }'

OpenAI 兼容 multipart 图像编辑#

POST /v1/images/edits 使用 multipart/form-data。参考图可以作为 image 或 image[] 文件上传,单次最多 20 张,单张不超过 10 MiB。

curl https://api.apimax.ai/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=nano-banana-2' \
  --form 'prompt=把背景换成海边日落' \
  --form 'image[]=@./photo.png' \
  --form 'response_format=url'

省略 response_format 时返回 b64_json;指定 url 时返回网关托管链接。mask 暂不转换为 Gemini Nano Banana 输入,局部编辑范围请在提示词中描述。

响应#

{
  "created": 1757165031,
  "data": [
    {
      "url": "",
      "b64_json": "<Base64 图像数据>",
      "revised_prompt": ""
    }
  ]
}

response_format 为 url 时,data[].url 返回网关托管链接,b64_json 为空。

行为说明#

• 同步等待:请求阻塞至上游出图完成;stream=true 不会启用流式,仍返回同步 JSON。
• 内容安全:上游拦截(如 SAFETY、PROHIBITED_CONTENT)时返回 HTTP 400,错误信息携带上游拦截原因。
• 计费:按张计价(价格随清晰度档位不同),按实际生成张数结算,未出图不计费。

错误码(HTTP)#