Nano Banana (Google Gemini Image)

1. 概述

google推出的文生图/图生图模型。

模型列表:

  • gemini-2.5-flash-image (Nano-Banana)

  • gemini-3-pro-image-preview (Nano-Banana-Pro)

本接口采用gemini原生接口。

2. 请求说明

  • 请求方法:POST

  • 请求地址:

    https://gateway.theturbo.ai/v1/v1beta/models/{model}:generateContent


3. 请求参数

3.1 Header 参数

参数名称
类型
必填
说明
示例值

Content-Type

string

设置请求头类型,必须为 application/json

application/json

Authorization

string

身份验证所需的 API_KEY,格式 Bearer $YOUR_API_KEY

Bearer $YOUR_API_KEY


3.2 Body 参数 (application/json)

参数名称
类型
必填
说明
示例

contents

array

与模型当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询(例如聊天),这是包含对话历史记录和最新请求的重复字段。

[{"role":"user","parts":[{"text":"A cute baby sea otter"}]}]

content.role

string

消息角色。必须是usermodel

user

content.parts

array

构成单条消息的有序 Parts。部分可能具有不同的 MIME 类型。

[{"text":"A cute baby sea otter"}]}]

content.parts.text

string

内嵌文本。

A cute baby sea otter

content.parts.inlineData

struct

内嵌媒体字节。

content.parts.inlineData.mimeType

string

来源数据的 IANA 标准 MIME 类型。

image/png

content.parts.inlineData.data

string

媒体格式的原始字节。使用 base64 编码的字符串。

generationConfig

struct

模型生成和输出的配置选项。

generationConfig.imageConfig

struct

图片生成配置。如果为不支持这些配置选项的模型设置此字段,系统将返回错误。

generationConfig.imageConfig.aspectRatio

string

可选。要生成的图片的宽高比。支持的宽高比:1:1 2:3 3:2 3:4 4:3 9:16 16:9 21:9

16:9

generationConfig.imageConfig.imageSize

string

指定生成图片的大小。支持的值为 1K2K4K

1K


4. 请求示例

4.1 文生图

4.2 图生图

支持的内联图片类型

image/png image/jpeg image/webp image/heic image/heif

5. 响应示例

最后更新于