API 介绍快速开始 Nano Banana Pro Nano Banana 2 Nano Banana 2 Lite

开始使用

快速开始

使用 Bearer Token、JSON 请求体以及 create 和 check 两个生产环境 Endpoint，即可快速开始使用 Nano Banana API。

您需要准备

A一个拥有可用积分的 Nano Banana 账号
从 API Key 控制台创建的 API Key

获取您的 API Key

登录后打开 API Key 页面，输入 Key 名称并点击创建。请立即复制 Key；完整 Key 只会显示一次。

配置 HTTP 请求 Header

Base URL

HTTPS

https://nanobanana.io

HTTP

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

快速开始

提交 JSON Payload 创建异步生成任务。请保存返回的 task_id ，并使用它查询任务状态。

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "一张未来感香蕉造型相机的电影级产品摄影",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

响应

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

创建任务

提交模型 ID 和 input 对象以创建异步生成任务。该 Endpoint 仅确认任务已进入队列，不会等待最终媒体结果生成完成。

POST/api/v1/create

身份验证

字段

类型

必填

说明与限制

Authorizationstring必填

在请求 Header 中以 Bearer Token 形式传入 API Key。示例： Authorization: Bearer sk_live_your_api_key

请求体

application/json

字段

类型

必填

说明与限制

modelstring必填

公开模型 ID。请使用 API 页面中列出的模型，例如 nano-banana-2。

inputobject必填

生成输入。必须包含非空的 prompt。其他 input 字段因模型而异；发送图片、宽高比、时长、分辨率或数量等字段前，请先查看对应模型文档。

JSON

{
  "model": "nano-banana-2",
  "input": {
    "prompt": "一张未来感香蕉造型相机的电影级产品摄影",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

创建响应

application/json

成功响应会返回任务 ID、模型 ID、排队状态以及该任务预留的积分数量。

HTTP 201

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

获取任务状态

使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。

POST/api/v1/check

请求体

application/json

字段

类型

必填

说明与限制

task_idstring必填

由 POST /api/v1/create 返回的任务 ID。使用该 ID 获取任务状态和最终结果 URL。

JSON

{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

状态响应

application/json

处理完成后，响应中会包含最终结果 URL 和时间相关元数据。任务仍在运行时，data 将返回为 null.

HTTP 200

{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}