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 分；失败任务自动退款。
图生图会先把参考图上传到对象存储，再调用 Nano Banana 生成。

生成图片

POST /api/v1/image/nano-banana，支持文生图与图生图。

方法: 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。
imageData（选填）：base64，需包含 data:image/xxx;base64, 前缀。
imageUrl（选填）：参考图直链，imageData 缺省时使用。

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

示例请求

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "prompt": "一只穿宇航服的香蕉猫在月球",
    "model": "nano-banana-pro",
    "mode": "text-to-image",
    "aspectRatio": "auto",
    "imageSize": "1K"
  }'

示例响应

{
  "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。

在线使用提升额度