Banana 图片接口文档

本文档说明 SiphonLab 美国 sub 节点当前支持的 Banana Pro / Banana 2 图片接口。

基础地址：

https://sub.siphonlab.cn

鉴权方式：

实际请求中二选一通常即可。为了兼容不同客户端，推荐同时带上以上两个请求头。

当前正式支持的接口：

POST /v1beta/models/{model}:generateContent

对应完整地址：

Banana Pro:
POST /v1beta/models/gemini-3-pro-image-preview:generateContent

Banana 2:
POST /v1beta/models/gemini-3.1-flash-image-preview:generateContent

通用规则

模型

当前支持两个模型：

gemini-3-pro-image-preview
gemini-3.1-flash-image-preview

推荐命名：

名称	模型 ID	说明
Banana Pro	`gemini-3-pro-image-preview`	高质量图片生成与编辑，适合 2K / 4K
Banana 2	`gemini-3.1-flash-image-preview`	低延迟图片生成与编辑

请求格式

使用 Gemini generateContent 格式：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "图片提示词"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

图片数量

Banana 接口不使用 n 参数。

一次请求通常按单张图片处理。如果需要多张图片，请客户端发起多次请求。

分辨率

使用 generationConfig.imageConfig.imageSize 控制分辨率：

1K
2K
4K

说明：

不传 imageSize 时，服务侧默认按 2K 处理。

imageSize 大小写不敏感，例如 1k 会按 1K 处理。

不支持 3K、8K 等非标准值。

画幅比例

使用 generationConfig.imageConfig.aspectRatio 控制比例：

1:1
16:9
9:16
4:3
3:4

说明：

Banana 接口按比例传参，不需要传 1024x1024 这种像素尺寸。

如果你的前端是按像素尺寸选择，可以映射为比例：

1024x1024 / 2048x2048 -> 1:1

2048x1152 / 3840x2160 -> 16:9

2160x3840 -> 9:16

2048x1536 -> 4:3

1536x2048 -> 3:4

响应格式

响应为 Gemini candidates 格式，图片通常在 inlineData 中返回：

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "生成说明或提示词改写"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "base64图片内容"
            }
          }
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 456,
    "totalTokenCount": 579
  }
}

客户端应遍历：

candidates[].content.parts[].inlineData.data

并按 inlineData.mimeType 保存图片格式。

1. 文生图接口

POST /v1beta/models/gemini-3-pro-image-preview:generateContent
POST /v1beta/models/gemini-3.1-flash-image-preview:generateContent

用途：根据文字提示词生成图片。

Content-Type：

Banana Pro 示例

Banana 2 示例

可用参数

参数	类型	必填	说明
`contents`	array	是	Gemini 对话内容
`contents[].role`	string	否	建议传 `user`
`contents[].parts[].text`	string	是	图片提示词
`contents[].parts[].inlineData`	object	否	图生图垫图
`generationConfig.responseModalities`	array	是	必须包含 `IMAGE`，建议传 `["TEXT","IMAGE"]`
`generationConfig.imageConfig.aspectRatio`	string	否	图片比例，如 `1:1`、`16:9`
`generationConfig.imageConfig.imageSize`	string	否	分辨率档位：`1K`、`2K`、`4K`

2. 图片编辑 / 图生图接口

Banana 图片编辑仍然使用同一个接口：

POST /v1beta/models/{model}:generateContent

区别是：除了 text 提示词，还需要在 parts 中放入图片 inlineData。

2.1 单张垫图

2.2 多张参考图

可以在 parts 中放多段 inlineData：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "参考这些图片，生成统一风格的新图"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "第一张图片base64"
          }
        },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "第二张图片base64"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

说明：

inlineData.data 只填纯 base64。

不要填 data:image/png;base64, 前缀。

mimeType 按实际图片类型填写，例如 image/png、image/jpeg、image/webp。

当前本地画布最多传 4 张参考图。

2.3 图片编辑参数

参数	类型	必填	说明
`contents[].parts[].text`	string	是	编辑说明
`contents[].parts[].inlineData.mimeType`	string	是	垫图 MIME 类型
`contents[].parts[].inlineData.data`	string	是	垫图 base64
`generationConfig.responseModalities`	array	是	必须包含 `IMAGE`
`generationConfig.imageConfig.aspectRatio`	string	否	输出比例
`generationConfig.imageConfig.imageSize`	string	否	输出分辨率档位

3. 流式返回

Gemini v1beta 通常支持流式接口：

POST /v1beta/models/{model}:streamGenerateContent?alt=sse

例如：

流式响应为 SSE。普通场景建议先使用非流式 generateContent。

常见错误

1. 把 Banana 模型发到 Images 接口

错误用法：

POST /v1/images/generations
model: gemini-3-pro-image-preview

正确用法：

POST /v1beta/models/gemini-3-pro-image-preview:generateContent
POST /v1beta/models/gemini-3.1-flash-image-preview:generateContent

2. 忘记要求返回图片

错误或不推荐：

{
  "generationConfig": {}
}

3. 使用像素尺寸代替比例

Banana 接口不是这样传：

{
  "size": "2048x1152"
}

正确方式：

{
  "generationConfig": {
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

4. 传了无效 imageSize

错误：

{
  "imageConfig": {
    "imageSize": "3K"
  }
}

正确：

{
  "imageConfig": {
    "imageSize": "1K"
  }
}

或：

{
  "imageConfig": {
    "imageSize": "2K"
  }
}

或：

{
  "imageConfig": {
    "imageSize": "4K"
  }
}

最小可用示例

Banana Pro 文生图：

Banana 2 文生图：

图生图：

一分钟，了解 Nio Flow ！

Banana 图片接口文档#

通用规则#

模型#

请求格式#

图片数量#

分辨率#

画幅比例#

响应格式#

1. 文生图接口#

Banana Pro 示例#

Banana 2 示例#

可用参数#

2. 图片编辑 / 图生图接口#

2.1 单张垫图#

2.2 多张参考图#

2.3 图片编辑参数#

3. 流式返回#

常见错误#

1. 把 Banana 模型发到 Images 接口#

2. 忘记要求返回图片#

3. 使用像素尺寸代替比例#

4. 传了无效 imageSize#

最小可用示例#