Nano Banana

ID：google/nano-banana

Google 推出的 Nano Banana 图片生成 API —— 基于 Gemini 2.5 Flash 的经济型模型，支持 11 种画面比例和最多 10 张参考图。

文生图图片编辑参考图

概览

Google 推出的 Nano Banana 图片生成 API —— 基于 Gemini 2.5 Flash 的经济型模型，支持 11 种画面比例和最多 10 张参考图。

认证

所有 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",
    "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",
    "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`
image_urls	string[]	可选	Reference images

输出 Schema

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

错误

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

状态码	描述
400	Requête invalide - paramètres manquants ou malformés
401	Échec de l'authentification - clé API manquante ou invalide
402	Crédits insuffisants
403	Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404	Exécution introuvable
429	Limite de requêtes dépassée
500	Erreur interne du serveur