Nano Banana API

nano banana api

站内图片生成接口，支持文生图 / 图生图。请在请求头使用 `Authorization: Bearer YOUR_API_KEY`，自动扣减与失败退款。更多细节见 /docs/nano-banana-api。

查看 API Keys 充值积分

调用前须知

接口为站内 Next API，请在请求头携带 `Authorization: Bearer YOUR_API_KEY`。
按模型扣积分：nano-banana-fast 5 分，nano-banana 15 分，nano-banana-pro 20 分；失败任务自动退款。
图生图请用 multipart/form-data 传最多 14 张参考图（单张 ≤10 MB），会先上传到对象存储再调用 Nano Banana。

生成图片

POST /api/v1/image/nano-banana，支持文生图与图生图；上传参考图时使用 multipart/form-data。

方法: POST路径: /api/v1/image/nano-banana

请求体字段

prompt（必填）：生成描述。
model（必填）：nano-banana-fast | nano-banana | nano-banana-pro。
mode（选填）：text-to-image（默认）或 image-to-image，图生图需参考图。
aspectRatio（选填）：默认 auto，可传 1:1, 16:9, 9:16 等。
imageSize（选填）：默认 1K，可传 1K/2K/4K。
imageFile（选填，FormData）：图生图参考文件，最多 14 张，单张 ≤10 MB。
imageUrl（选填）：参考图直链，字符串或字符串数组，计入 14 张上限。
imageData（选填，兼容）：仍接受 base64 data URL，但推荐用 FormData 上传文件以避免体积过大。

失败返回：400：缺少必填参数 / 图生图无参考图 / 模型无效。；401：未登录。；402：积分不足。；500：服务配置异常或下游错误。

示例请求

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

示例响应

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

查询结果

POST /api/v1/image/nano-banana/result，返回进度与图片 URL，失败自动退款。

方法: POST路径: /api/v1/image/nano-banana/result

请求体：taskId 或 id（字符串）。返回字段与生成接口一致，status=failed 时积分已退。

失败返回：400：缺少任务 ID。；401：未登录。；500：下游查询失败或服务异常。

示例请求

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"
  }'

示例响应

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

开始调用

携带 API Key 直接调用站内接口，更多细节请查看 /docs/nano-banana-api。

在线使用提升额度