图片 API 站
一毛一张图

上传参数

上传接口使用 multipart/form-data，由客户端自动设置 Content-Type 和 boundary；不要使用 application/json 或手动填写不含 boundary 的 multipart/form-data。

上传示例

curl -X POST https://www.nano-banana.cn/api/storage/upload-image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "files=@./reference.png" \
  -F "files=@./reference-2.jpg"

上传响应与图生图衔接

{
  "code": 0,
  "message": "ok",
  "data": {
    "urls": [
      "https://r2.nano-banana.cn/uploads/example.png"
    ],
    "results": [
      {
        "url": "https://r2.nano-banana.cn/uploads/example.png",
        "key": "uploads/example.png",
        "filename": "reference.png"
      }
    ]
  }
}

data.urls 是按上传顺序返回的图片地址数组；data.results 包含各文件的 url、存储 key 和原始 filename。示例域名仅用于说明，请使用实际返回的 URL。

将 data.urls 传入 POST /api/ai/generate/ 的 options.image_urls，并设置 scene 为 image-to-image。参考图数量、格式及大小仍须满足所选模型和站点预检限制。

除 HTTP 状态外，还须检查业务 code：0 表示成功，-1 表示失败。常见错误包括 no auth, please sign in、No files provided、File … is not an image 和 upload image failed。多文件上传中途失败时，之前的文件可能已保存；只有 code 为 0 时才使用返回的完整 URL 数组。

请求参数

请求示例（curl）

# 提交一个生图任务
curl -X POST https://www.nano-banana.cn/api/ai/generate/ \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaType": "image",
    "model": "nanobanana-2",
    "prompt": "a cute panda eating bamboo",
    "scene": "text-to-image",
    "options": { "aspectRatio": "1:1" }
  }'

# 响应
# { "code": 0, "message": "ok", "data": { "id": "3f2a1b4c-...", "status": "queuing" } }

图生图示例：分别指定画质与分辨率

{
  "mediaType": "image",
  "model": "gpt-image-2-official",
  "prompt": "Replace the background with a white studio backdrop",
  "scene": "image-to-image",
  "options": {
    "image_urls": [
      "https://your-server.com/reference.png"
    ],
    "aspectRatio": "16:9",
    "resolution": "2K",
    "quality": "medium"
  }
}

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "3f2a1b4c-...",
    "status": "queuing"
  }
}

调用限制与注意事项

API 调用要求付费用户，无需传 captchaToken；验证码不能代替付费资格。未付费账号调用将返回 paid account required for API access。当前不支持 webhook 回调，callbackUrl 不会生效，请通过 query 轮询。参考图建议每张不超过 20MB，必须提供可访问的原图链接；示例中的参考图地址需替换为真实地址。

请求参数

请求示例（curl）

# 轮询任务结果
curl -X POST https://www.nano-banana.cn/api/ai/query/ \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "3f2a1b4c-..." }'

# 处理中响应
# { "code": 0, "data": { "id": "...", "status": "processing", "outputImages": null } }

# 成功响应
# { "code": 0, "data": { "id": "...", "status": "success", "outputImages": ["https://r2.nano-banana.cn/outputs/xxx.png"] } }

任务状态说明