API 文档 & 在线体验

完全兼容 Gemini 官方接口

我们的 API 与 Google Gemini 官方接口格式完全兼容。您只需将官方 API 的请求域名从 generativelanguage.googleapis.com 替换为 api.nanobananai.com 即可，包括模型名称在内的所有其他参数和请求体结构都保持不变。

API 端点 (Endpoint)

将您的请求发送至以下地址。模型名称 gemini-3-pro-image-preview 无需更改。

请求方法: POST

https://api.nanobananai.com/v1beta/models/gemini-3-pro-image-preview:generateContent

请求示例 (cURL)

curl -X POST \
  'https://api.nanobananai.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
        "parts": [
            {"inline_data": {"mime_type": "image/png", "data": "..."}},
            {"text": "让这只猫戴上宇航员头盔"}
        ]
    }],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
  }'

关键参数说明

generationConfig.responseModalities

此字段用于指定期望的响应模式类型。当设置为 ["IMAGE"] 时，API 会返回图片数据。**此字段为可选项，不传递时使用默认行为。**

tools.google_search

启用 Google 搜索接地 (Google Search Grounding) 功能，让 AI 先通过 Google 搜索获取实时信息，再基于这些数据生成图片。

适用场景：

• 🌤️ 实时天气预报可视化
• 📈 股市图表生成
• 📰 最新新闻事件信息图
• ⚽ 体育赛事数据可视化

generationConfig.imageConfig.aspectRatio

此字段用于控制生成图片的宽高比。**如果您不提供 aspectRatio 字段，API 将默认返回与输入图片最接近的原图比例。**

支持的比例值：

• 1:1
• 2:3 , 3:2
• 3:4 , 4:3
• 4:5 , 5:4
• 9:16 , 16:9
• 21:9

generationConfig.imageConfig.imageSize

此字段用于控制生成图片的分辨率。**如果不提供此字段，默认使用 1K 分辨率。**

支持的分辨率值：

• 1K - 低分辨率，生成速度快（默认）
• 2K - 标准分辨率
• 4K - 高分辨率，细节更丰富

在线交互体验 (Live Demo)