Nano Banana 2.1 图片 API

模型 ID：gemini-nano-banana-2.1。支持文生图和参考图编辑，输出分辨率为 1K、2K、4K，每次请求一张图片。

使用 Images API。直接调用 /v1/chat/completions 会被拒绝。图片接口不支持 stream=true，n 只能为 1；当前不支持 mask。

文生图

POST https://apimaster.ai/v1/images/generations，请求体为 JSON。

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "prompt": "A lavender ceramic teapot beside two green pears, white background",
    "size": "1:1",
    "resolution": "1K",
    "n": 1,
    "response_format": "url"
  }'

参考图编辑

POST https://apimaster.ai/v1/images/edits，使用 multipart/form-data 上传实际参考图片；不要手工设置 multipart 的 Content-Type，cURL 会添加正确的 boundary。

curl --max-time 300 "https://apimaster.ai/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gemini-nano-banana-2.1" \
  -F "prompt=Keep all foreground objects and lettering. Change only the background to mint green." \
  -F "image=@reference.png" \
  -F "size=1:1" \
  -F "resolution=2K" \
  -F "n=1" \
  -F "response_format=url"

也可以在 /images/generations 的 JSON 请求中提供 image_urls，内容为公网图片 URL 或完整的 data:image/png;base64,...。最多支持 14 张参考图；仅在提示词中提及参考图不会上传图片。

{
  "model": "gemini-nano-banana-2.1",
  "prompt": "Preserve the subject and lettering; change the background to mint green.",
  "image_urls": ["https://example.com/reference.png"],
  "size": "1:1",
  "resolution": "2K",
  "n": 1
}

请求参数

字段	说明
model	必填，固定为 gemini-nano-banana-2.1
prompt	必填，画面描述或编辑要求
resolution	1K、2K、4K；建议显式传入，默认 1K
size	宽高比，默认 1:1；也接受可转换为支持比例的像素尺寸，如 1024x1024
n	仅支持 1
response_format	url 或 b64_json
image	/images/edits 的 multipart 参考图文件
image_urls	/images/generations 的 JSON 参考图数组

支持宽高比：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1。

显式 resolution 决定输出分辨率及扣费档位，size 决定画面比例。例如 size=1024x1024、resolution=4K 是正方形 4K 请求，并非 1K。

图片价格与扣费

以下为 2026-10-07 核验的基础价，单位为美元／张，不是每千张价格：

分辨率	基础价格	default 用户实测价格（系数 1.05）
1K	$0.0336	$0.03528
2K	$0.0504	$0.05292
4K	$0.0756	$0.07938

用户价格 = 分辨率基础价 × 渠道分组系数 × 充值系数 × 模型/APIMaster 系数 × 用户分组系数 × 实际返回图片数，按平台 quota 精度结算。示例使用渠道 38，其渠道、充值和模型系数均为 1；其他渠道或用户分组可能不同，以模型广场及消费日志为准。生成和编辑均使用图片定价，渠道的 token 单价不替代图片基础价。

响应与使用日志

{
  "created": 1791339727,
  "data": [{"url": "https://apimaster.ai/imgs/IMAGE_ID.png"}]
}

response_format=b64_json 时，图片位于 data[0].b64_json，请自行解码保存。图片 URL 请及时下载或转存。使用日志保存 result_url、实际图片数及 request_data.effective_resolution，支持缩略图预览和打开大图。

生产实测分别返回 1024×1024、2048×2048、4096×4096；2K 编辑保留了参考图的图形、颜色及文字，只改变了背景。

调用注意事项

• 在控制台创建 API Key，通过 Authorization: Bearer YOUR_API_KEY 认证。
• 建议 HTTP 读超时为 300 秒，高分辨率可能需要更长等待。
• 参数错误、无效密钥、余额不足、限流或上游异常会返回错误；没有图片结果不会按成功图片结算。
• 参考图应可被上游读取；上传文件或 data URI 可避免不可访问的 URL。