> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/compute/aig/image-edit/nano-banana-image-edit.md).

# Nano Banana (Google Gemini Image)

## 1.概述

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

{% hint style="success" %}
本 API 与 OpenAI 接口格式兼容。
{% endhint %}

**模型列表：**

* `gemini-2.5-flash-image` (Nano-Banana)
* `gemini-3-pro-image` (Nano-Banana-Pro)
* `gemini-3.1-flash-image` (Nano-Banana-2)
* `gemini-3.1-flash-lite-image` (Nano-Banana-2-Lite)

{% hint style="warning" %}
本模型为多模态模型，描述需要明确包含绘制的画面或明确要求绘图，简单字词可能无图片输出。
{% endhint %}

## 2. 请求说明

* **请求方法**:`POST`
* **请求地址**:

  > `https://gateway.theturbo.ai/v1/images/edits`

***

## 3.请求参数

### 3.1 Head参数

| 参数名称            | 类型     | 必填 | 说明                                        | 示例值                                                                            |
| --------------- | ------ | -- | ----------------------------------------- | ------------------------------------------------------------------------------ |
| `Content-Type`  | string | 是  | 设置请求头类型，必须为`multipart/form-data`          | `multipart/form-data; boundary=------------------------y0QNRDhXQUE3yHQi7DEbLz` |
| `Accept`        | string | 是  | 设置响应类型，必须为 `application/json`             | `application/json`                                                             |
| `Authorization` | string | 是  | 身份验证所需的 API\_KEY，格式`Bearer $YOUR_API_KEY` | `Bearer $YOUR_API_KEY`                                                         |

### 3.2 Body 参数 (multipart/form-data)

| 参数名称              | 类型              | 必填 | 说明                                                                                                   | 示例值(默认值)                 |
| ----------------- | --------------- | -- | ---------------------------------------------------------------------------------------------------- | ------------------------ |
| **model**         | string          | 是  | 要使用的模型 ID。详见概述列出的可用版本，如 gemini-2.5-flash-image。                                                      | `gemini-2.5-flash-image` |
| **prompt**        | string          | 是  | 一段描述所需图像的文字。（本模型为多模态模型，描述需要明确包含绘制的画面或明确要求绘图，简单字词可能无图片输出）                                             | `A cute baby sea otter`  |
| **image**         | file/file array | 否  | `gemini-2.5-flash-image` 最多可接受 3 张图片作为输入，而 `gemini-3-pro-image-preview` 最多可接受 14 张图片，其中 5 张图片可实现高保真度 |                          |
| aspect\_ratio     | string          | 否  | 要生成的图片的宽高比。支持的宽高比:`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9` 或 `21:9`。                  |                          |
| image\_size       | string          | 否  | 指定生成的图片的大小,支持的值为 1K、2K、4K                                                                            | `1K`                     |
| media\_resolution | string          | 否  | 输入媒体的媒体分辨率 `MEDIA_RESOLUTION_LOW` `MEDIA_RESOLUTION_MEDIUM` `MEDIA_RESOLUTION_HIGH`                  |                          |

## 4.请求示例

{% tabs %}
{% tab title="单图片" %}

```http
curl -X POST https://gateway.theturbo.ai/v1/images/edits \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F model="gemini-2.5-flash-image" \
	-F image="@input.png" \
	-F prompt="A cute baby sea otter wearing a beret" \
	-F 其他参数
```

{% endtab %}

{% tab title="多图片" %}

```sh
curl -X POST https://gateway.theturbo.ai/v1/images/edits \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F model="gemini-2.5-flash-image" \
	-F image[]="@input1.png" \
	-F image[]="@input2.png" \
	-F prompt="A cute baby sea otter wearing a beret" \
	-F 其他参数
```

{% endtab %}
{% endtabs %}

## 5.响应示例

```json
{
	"created": 1589478378,
	"data": [
		{
			"b64_json": "..."
		},
		{
			"b64_json": "..."
		}
	]
}
```