NanoBanana 图像生成部署指南

通过 callxyq 调用 Gemini 原生图像生成 API

资源	地址
	callxyq 平台

📋 简介

NanoBanana 是 callxyq 提供的 Gemini 图像生成 model 系列。通过 callxyq 的 API Key 即可直接调用，无需科学上网，无需谷歌账号。

🎯 模型介绍

callxyq 提供两个 NanoBanana 模型：

模型	模型 ID	特点	适用场景
NanoBananaPro	`gemini-3-pro-image-preview`	效果最佳，支持高清输出	高质量海报、商业素材、精细创作
NanoBanana2	`gemini-3.1-flash-image-preview`	速度快、价格低	快速预览、批量生成、日常使用

💡 如何选择

追求画质：选 NanoBananaPro（Pro 版）
追求速度和性价比：选 NanoBanana2（Flash 版）

📐 支持的宽高比

两个模型均支持以下 10 种宽高比：

宽高比	说明	宽高比	说明
1:1	正方形图片	3:2	相机常用比例（横）
16:9	横屏标准比例	2:3	相机常用比例（竖）
9:16	竖屏标准比例	21:9	超宽屏比例
4:3	传统横屏比例	5:4	显示器比例（横）
3:4	传统竖屏比例	4:5	显示器比例（竖）

📏 支持的分辨率

每种宽高比支持三种分辨率等级：

1K 分辨率（快速预览）

宽高比	分辨率	宽高比	分辨率
1:1	1024×1024	3:2	1232×816
16:9	1376×768	2:3	816×1232
9:16	768×1376	21:9	1584×672
4:3	1200×896	5:4	1136×896
3:4	896×1200	4:5	896×1136

2K 分辨率（推荐使用）

宽高比	分辨率	宽高比	分辨率
1:1	2048×2048	3:2	2464×1632
16:9	2752×1536	2:3	1632×2464
9:16	1536×2752	21:9	3168×1344
4:3	2400×1792	5:4	2272×1792
3:4	1792×2400	4:5	1792×2272

4K 分辨率（超高清）

宽高比	分辨率	宽高比	分辨率
1:1	4096×4096	3:2	4928×3264
16:9	5504×3072	2:3	3264×4928
9:16	3072×5504	21:9	6336×2688
4:3	4800×3584	5:4	4544×3584
3:4	3584×4800	4:5	3584×4544

🔧 API 请求格式

NanoBanana 使用谷歌原生格式 API，与 OpenAI 格式不同。

基本请求结构

json

{
  "contents": [{
    "parts": [
      { "text": "您的图片描述" }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "image_size": "2K"
    }
  }
}

参数说明

参数	说明	可选值
`responseModalities`	响应类型，必须设为图片	`["IMAGE"]`
`aspectRatio`	宽高比	`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`21:9`、`5:4`、`4:5`
`image_size`	分辨率等级	`1K`、`2K`、`4K`

API 端点

http

POST https://callxyq.xyz/v1beta/models/{模型ID}:generateContent

NanoBananaPro：gemini-3-pro-image-preview
NanoBanana2：gemini-3.1-flash-image-preview

📝 示例代码

cURL 示例

bash

curl -X POST "https://callxyq.xyz/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "一只可爱的小猫咪坐在花园里，油画风格，高清，细节丰富"}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "image_size": "2K"
      }
    }
  }'

Python 示例

python

import requests
import base64

API_KEY = "sk-你的callxyq密钥"
API_URL = "https://callxyq.xyz/v1beta/models/gemini-3-pro-image-preview:generateContent"

payload = {
    "contents": [{
        "parts": [
            {"text": "一只可爱的小猫咪坐在花园里，油画风格，高清，细节丰富"}
        ]
    }],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "image_size": "2K"
        }
    }
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(API_URL, headers=headers, json=payload, timeout=600)

if response.status_code == 200:
    data = response.json()
    image_base64 = data["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]

    # 保存图片
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(image_base64))
    print("图片已保存为 output.png")
else:
    print(f"请求失败: {response.status_code}")
    print(response.text)

Node.js 示例

javascript

const fs = require('fs');

const API_KEY = 'sk-你的callxyq密钥';
const API_URL = 'https://callxyq.xyz/v1beta/models/gemini-3-pro-image-preview:generateContent';

async function generateImage() {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      contents: [{
        parts: [
          { text: '一只可爱的小猫咪坐在花园里，油画风格，高清，细节丰富' }
        ]
      }],
      generationConfig: {
        responseModalities: ['IMAGE'],
        imageConfig: {
          aspectRatio: '16:9',
          image_size: '2K'
        }
      }
    })
  });

  const data = await response.json();
  const imageBase64 = data.candidates[0].content.parts[0].inlineData.data;

  fs.writeFileSync('output.png', Buffer.from(imageBase64, 'base64'));
  console.log('图片已保存为 output.png');
}

generateImage().catch(console.error);

🖼️ 图生图编辑

NanoBananaPro 还支持图生图功能，上传一张图片并描述编辑指令，即可对图片进行修改。

json

{
  "contents": [{
    "parts": [
      {
        "inlineData": {
          "mimeType": "image/png",
          "data": "图片的Base64编码字符串"
        }
      },
      { "text": "将背景改为星空，保持人物不变" }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "image_size": "2K"
    }
  }
}

💡 图生图使用技巧

编辑指令要具体明确，说清楚保留什么、修改什么
支持换背景、改风格、加元素、去水印等操作
图片需要转为 Base64 编码后放入 inlineData.data 字段

🤖 在 Claude Code 中使用

如果您已安装 ikunimage Skill，可以在 Claude Code 对话中直接使用自然语言生成图片，无需手动调用 API。

text

> ikun 画一张赛博朋克风格的城市夜景，16:9 比例，2K 分辨率

> ikun 生成一张水墨风格的山水画，竖屏 9:16

> 用 ikun 编辑这张图片 /path/to/image.png，把背景换成海边日落

详细安装和使用说明请参考：ikunimage AI 生图

⏱️ 性能建议

分辨率	推荐超时	适用场景
1K	360 秒（6 分钟）	快速预览、测试效果
2K	600 秒（10 分钟）	日常使用（推荐）
4K	1200 秒（20 分钟）	超高清输出、商业用途

带宽注意

图片数据使用 Base64 编码传输，数据量较大：

建议使用稳定高速的网络连接
4K 图片的 Base64 数据可能超过 10MB
避免在网络高峰时段生成 4K 图片

⚠️ 注意事项

API Key：需从 callxyq 平台创建支持图像模型的令牌
API 格式：NanoBanana 使用谷歌原生格式，不是 OpenAI 兼容格式，请注意区分
分辨率与耗时：分辨率越高，生成时间越长，请根据实际需求选择
文字渲染：支持在图片中渲染中文文字（如招牌、海报文案），在 prompt 中直接写明即可
价格差异：不同模型和分辨率价格不同，详见 callxyq 平台定价页面

NanoBanana 图像生成部署指南 ​

🎯 模型介绍 ​

📐 支持的宽高比 ​

📏 支持的分辨率 ​

1K 分辨率（快速预览） ​

2K 分辨率（推荐使用） ​

4K 分辨率（超高清） ​

🔧 API 请求格式 ​

基本请求结构 ​

参数说明 ​

API 端点 ​

📝 示例代码 ​

cURL 示例 ​

Python 示例 ​

Node.js 示例 ​

🖼️ 图生图编辑 ​

🤖 在 Claude Code 中使用 ​

⏱️ 性能建议 ​

推荐超时时间 ​

带宽注意 ​

⚠️ 注意事项 ​