Google 官方模型页将
gemini-3.1-flash-lite-image 列为 Nano Banana Lite 的稳定模型 ID,最新更新时间为 2026 年 6 月。该模型面向低于 2 秒的端到端延迟、更低 TPU 计算成本和高并发图片生成/编辑场景优化。核心能力
- 文生图 — 根据文本描述生成图片
- 图片编辑 — 在
inline_data中传入参考图,配合文字指令进行编辑 - 低延迟 — 面向低于 2 秒的端到端延迟优化
- 宽高比控制 —
1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9 - 分辨率控制 — 支持
1K(1024px)。不支持 2K 和 4K - 思考级别 — 支持
minimal和high - 多模态输出 — 通过
responseModalities: ["TEXT", "IMAGE"]同时返回图片和文字说明 - 水印 — SynthID 始终开启,并支持 C2PA 水印
注意: 如果需要生成的图片返回 URL,请在创建 API 令牌时选择 Aggregate-NanoUrl 分组。
文生图示例
curl "https://www.anyfast.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "生成一张山间日落的图片" }
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
}'
import requests, base64
url = "https://www.anyfast.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent"
response = requests.post(url, params={"key": "YOUR_API_KEY"}, json={
"contents": [
{
"role": "user",
"parts": [{"text": "生成一张山间日落的图片"}]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}
}
})
for part in response.json()["candidates"][0]["content"]["parts"]:
image_part = part.get("inlineData")
if image_part:
with open("output.jpg", "wb") as f:
f.write(base64.b64decode(image_part["data"]))
print("图片已保存至 output.jpg")
elif "text" in part:
print("说明文字:", part["text"])
import google.genai as genai
client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(
model="gemini-3.1-flash-lite-image",
contents="生成一张山间日落的图片",
config={
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
)
for candidate in response.candidates:
for part in candidate.content.parts:
if part.inline_data:
with open("output.jpg", "wb") as f:
f.write(part.inline_data.data)
print("图片已保存至 output.jpg")
elif part.text:
print("说明文字:", part.text)
图片编辑示例(传入参考图)
在同一个parts 数组中同时传入 text 指令和 inline_data 参考图。
# 先将图片转为 base64:
# BASE64=$(base64 -i your_photo.jpg)
#
# 然后发送请求:
curl "https://www.anyfast.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "这是我的一张照片,请在我旁边加一只羊驼"
},
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "<YOUR_BASE64_ENCODED_IMAGE>"
}
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
}'
import requests, base64
# 读取并编码参考图片
with open("your_photo.jpg", "rb") as f:
image_b64 = base64.b64encode(f.read()).decode("utf-8")
url = "https://www.anyfast.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent"
response = requests.post(url, params={"key": "YOUR_API_KEY"}, json={
"contents": [
{
"role": "user",
"parts": [
{
"text": "这是我的一张照片,请在我旁边加一只羊驼"
},
{
"inline_data": {
"mime_type": "image/jpeg",
"data": image_b64 # ← 将 base64 字符串粘贴至此
}
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
}
})
for part in response.json()["candidates"][0]["content"]["parts"]:
image_part = part.get("inlineData")
if image_part:
with open("output.jpg", "wb") as f:
f.write(base64.b64decode(image_part["data"]))
print("图片已保存至 output.jpg")
elif "text" in part:
print("说明文字:", part["text"])
import google.genai as genai
from google.genai import types
client = genai.Client(api_key="YOUR_API_KEY")
# 读取图片
with open("your_photo.jpg", "rb") as f:
image_bytes = f.read()
response = client.models.generate_content(
model="gemini-3.1-flash-lite-image",
contents=[
"这是我的一张照片,请在我旁边加一只羊驼",
types.Part.from_bytes(data=image_bytes, mime_type="image/jpeg")
],
config={
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
)
for candidate in response.candidates:
for part in candidate.content.parts:
if part.inline_data:
with open("output.jpg", "wb") as f:
f.write(part.inline_data.data)
print("图片已保存至 output.jpg")
elif part.text:
print("说明文字:", part.text)
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
key | string | 是 | API 密钥(查询参数) |
contents[].parts[].text | string | 是 | 文字提示或指令 |
contents[].parts[].inline_data.mime_type | string | 否 | 参考图类型:image/jpeg、image/png、image/webp |
contents[].parts[].inline_data.data | string | 否 | Base64 编码的参考图数据 |
generationConfig.responseModalities | array | 是 | ["IMAGE"] 或 ["TEXT", "IMAGE"] |
generationConfig.imageConfig.aspectRatio | string | 否 | 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 |
generationConfig.imageConfig.imageSize | string | 否 | 仅支持 1K。不支持 2K 和 4K |
API 参考
查看 Gemini 3.1 Flash Lite Image 的交互式 API Playground。