Nano Banana Pro

ID：google/nano-banana-pro

Google 推出的 Nano Banana Pro 图片生成 API —— 基于 Gemini 3 Pro，文字渲染最锐利，支持 4K 输出，家族中画质最高。

文生图图片编辑参考图4K文字渲染

概览

Google 推出的 Nano Banana Pro 图片生成 API —— 基于 Gemini 3 Pro，文字渲染最锐利，支持 4K 输出，家族中画质最高。

认证

所有 API 请求需要通过 Authorization 请求头以 Bearer 方式传递有效的 API 密钥。

快速开始

凭证

设置 RUNBASE_API_KEY 环境变量。

Shell

export RUNBASE_API_KEY=your-api-key

创建运行

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "input": {
      "prompt": "一张陶瓷台灯的电影级产品照片"
    }
  }'

运行记录

运行以异步方式处理。提交请求后，轮询获取结果。

创建运行

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "input": { "prompt": "一张陶瓷台灯的电影级产品照片" }
  }'

获取运行状态

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

获取结果

轮询状态接口，直到 status 为 "succeeded"，然后从响应中读取 output.urls。

输入 Schema

参数	类型	必填	描述
prompt	string	必填	Prompt
aspect_ratio	string	可选	Aspect ratio选项： `1:12:33:23:44:34:55:49:1616:921:9auto`
resolution	string	可选	Resolution选项： `1K2K4K`
image_urls	string[]	可选	Reference images

输出 Schema

字段	类型	描述
urls	string[]	生成的输出 URL

错误

API 使用标准 HTTP 状态码表示成功或失败。

状态码	描述
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ