API 手册图片
NanoBanana 图片
使用 Gemini 图片模型生成、编辑和迭代图片
本页整理 RouteMarket 的 NanoBanana 图片 兼容接口,包括可识别的端点、结构化参数和请求示例。
兼容性提示:页面由公开协议中的技术字段生成。具体模型、额度和路由能力以 RouteMarket 控制台及实际网关响应为准。
参数参考
参数表 1
| 项目 | 说明 |
|---|---|
| 方法 | 相关值:POST |
| 路径 | 相关值:/v1beta/models/{model}:generateContent |
| Base URL | 相关值:https://api.routemarket.ai |
| 请求格式 | 相关值:application/json |
| 认证 | 相关值:?key=$ROUTEMARKET_API_KEY |
| 返回图片 | 相关值:candidates[].content.parts[].inlineData.data |
参数表 2
| 模型 | 适合场景 |
|---|---|
gemini-3.1-flash-image-preview | 日常图片生成首选,质量、速度和成本比较均衡 |
gemini-3-pro-image-preview | 专业素材、复杂指令、高分辨率输出 |
gemini-2.5-flash-image | 低延迟、大批量、基础图片任务 |
参数表 3
| 模型 | 图片尺寸 | 参考图 |
|---|---|---|
gemini-2.5-flash-image | 约 1K | 最多 3 张 |
gemini-3.1-flash-image-preview | 512px、1K、2K、4K | 最多 14 张 |
gemini-3-pro-image-preview | 1K、2K、4K | 最多 14 张 |
参数表 4
| 目标 | 写法 |
|---|---|
| 写实图片 | 描述主体、环境、镜头、光线、材质 |
| 产品图 | 明确背景、角度、阴影、品牌文字是否需要出现 |
| 图片编辑 | 说明“保留什么”和“只修改什么” |
| 多图合成 | 指明每张参考图的用途,例如“第一张是产品,第二张是场景” |
参数表 5
| 问题 | 处理方式 |
|---|---|
| 没有图片返回 | 检查 responseModalities 是否包含 IMAGE |
| 参数被拒绝 | 检查字段大小写,例如 inlineData、mimeType、imageSize |
| 只想拿 URL | 改用 异步图片任务 |
| 图片数量不稳定 | 图片模型不保证严格按数量返回,批量任务建议用异步接口 |
请求与响应示例
示例 1
from google import genai
from PIL import Image
client = genai.Client(
api_key="sk-xxx",
http_options={"base_url": "https://api.routemarket.ai"},
)
response = client.models.generate_content(
model="gemini-3.1-flash-image-preview",
contents=[
Image.open("input.jpg"),
"保留主体和构图,把背景改成雨夜霓虹街道",
],
)
for part in response.candidates[0].content.parts:
if part.inline_data:
part.as_image().save("edited.png")
break示例 2
from google import genai
from google.genai import types
from PIL import Image
client = genai.Client(
api_key="sk-xxx",
http_options={"base_url": "https://api.routemarket.ai"},
)
response = client.models.generate_content(
model="gemini-3-pro-image-preview",
contents=[
Image.open("product.png"),
Image.open("scene.png"),
"把第一张产品自然放入第二张场景中,保持光影一致",
],
config=types.GenerateContentConfig(
response_modalities=["IMAGE"],
image_config=types.ImageConfig(
aspect_ratio="16:9",
image_size="2K",
),
),
)
for part in response.candidates[0].content.parts:
if part.inline_data:
part.as_image().save("composite.png")
break示例 3
{
"candidates": [
{
"content": {
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "<BASE64_IMAGE_DATA>"
}
}
],
"role": "model"
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 20,
"candidatesTokenCount": 1120,
"totalTokenCount": 1140
}
}接入说明
- API 基础地址:
https://api.routemarket.ai - 推荐密钥环境变量:
ROUTEMARKET_API_KEY - 请求使用
Authorization: Bearer <API_KEY>。 - 上线前请用实际账号验证端点、模型名、限额与异步任务状态。