RouteMarket 文档
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-preview512px1K2K4K最多 14 张
gemini-3-pro-image-preview1K2K4K最多 14 张

参数表 4

目标写法
写实图片描述主体、环境、镜头、光线、材质
产品图明确背景、角度、阴影、品牌文字是否需要出现
图片编辑说明“保留什么”和“只修改什么”
多图合成指明每张参考图的用途,例如“第一张是产品,第二张是场景”

参数表 5

问题处理方式
没有图片返回检查 responseModalities 是否包含 IMAGE
参数被拒绝检查字段大小写,例如 inlineDatamimeTypeimageSize
只想拿 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>
  • 上线前请用实际账号验证端点、模型名、限额与异步任务状态。