跳到主要内容

Nano Banana

nano-banana-1 与 nano-banana-2 使用 PopGo 的图片生成兼容入口。它们适合根据文字创建图片，也适合在图片编辑接口中提供参考图来保持主体、风格或构图的一致性。

调用地址​

POST https://api.popgo.site/v1/images/generations
POST https://api.popgo.site/v1/images/edits
Authorization: Bearer YOUR_API_KEY

文生图使用 JSON。图像编辑使用 multipart/form-data，参考图片放在 image 或重复的 image[] 字段中。

模型选择​

模型推荐用途注意
nano-banana-1日常文生图、参考图编辑分辨率、比例和数量以模型与价格页为准
nano-banana-2更高版本的图片生成和编辑不要把其他模型的专用字段直接复制过来

字段​

字段类型说明
modelstring必填，使用上表的公开模型 ID
promptstring必填，描述生成或修改目标
sizestring可选，使用模型与价格页列出的 WIDTHxHEIGHT 或 auto
qualitystring可选，仅在实时能力页列出时使用
ninteger可选，返回数量，默认 1
response_formatstring可选，url 或 b64_json
image / image[]file仅图像编辑，上传一张或多张参考图

文生图示例​

curl https://api.popgo.site/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "prompt": "一张干净的产品目录图，白色背景，柔和侧光",
    "size": "1024x1024",
    "n": 1
  }'

参考图编辑示例​

curl https://api.popgo.site/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=YOUR_MODEL" \
  -F "image=@reference.png" \
  -F "prompt=保持人物姿态和服装结构，将背景改成明亮的工作室"

多图时重复字段名，并在提示词中明确“第一张”“第二张”等相对顺序：

curl https://api.popgo.site/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=YOUR_MODEL" \
  -F "image[]=@subject.png" \
  -F "image[]=@palette.png" \
  -F "prompt=以第一张图为主体，参考第二张图的色彩和质感"

响应格式​

url 响应在 data[].url 返回结果地址；b64_json 响应在 data[].b64_json 返回不带 Data URL 前缀的 Base64 图片内容。URL 可能过期，Base64 体积较大，客户端应根据存储方式选择格式。

限制与排查​

  • 不要把 size、quality、比例或其他模型的专用参数当成两个 Nano Banana 模型的必填字段。
  • 编辑请求的参考图使用 multipart 文件字段，不要将本地文件路径写入 JSON。
  • 如果上传多张图片后返回 400，先减少到一张，再检查图片格式、大小和实时模型能力。
  • n 会增加返回数量和额度消耗；生产环境按实际需要设置。

计费、可用规格和参考图上限以模型与价格页的实时配置为准。