面向 nano-banana-2 的图片生成 API

请求体字段

• prompt（必填）：生成描述。
• model（必填）：建议固定为 nano-banana-2。
• mode（选填）：text-to-image（默认）或 image-to-image，图生图至少需 1 张参考图。
• aspectRatio（选填）：默认 auto，可传 1:1、16:9、9:16 等。
• imageSize（选填）：默认 1K，可传 1K/2K/4K。
• outputFormat（选填）：默认 png。
• isPublic（选填）：默认 true。
• imageFile（选填，FormData）：图生图参考文件，最多 8 张，单张 <=10 MB。
• imageUrl（选填）：参考图直链，字符串或字符串数组，计入 8 张上限。
• imageData（选填，兼容）：仍接受 base64 data URL，但推荐用 FormData 上传文件以避免体积过大。

示例请求

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana \
  -H "Authorization: Bearer api-key" \
  -F "prompt=一只穿宇航服的香蕉猫在月球" \
  -F "model=nano-banana-2" \
  -F "mode=image-to-image" \
  -F "aspectRatio=auto" \
  -F "imageSize=1K" \
  -F "outputFormat=png" \
  -F "isPublic=true" \
  -F "imageFile=@/path/to/ref.png" \
  -F "imageUrl=https://example.com/ref2.png"

示例响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task-id-xxx",
    "results": [],
    "progress": 0,
    "status": "running",
    "failure_reason": null,
    "error": null,
    "credits_cost": 20
  }
}

示例请求

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana/result \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "taskId": "task-id-xxx"
  }'

示例响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task-id-xxx",
    "results": [
      {
        "url": "https://example.com/generated.png",
        "content": "一只穿宇航服的香蕉猫在月球"
      }
    ],
    "progress": 100,
    "status": "succeeded",
    "failure_reason": null,
    "error": null
  }
}