API 文档 & 在线体验

完全兼容 Gemini 官方接口

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

API 端点 (Endpoint)

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

请求方法: POST

https://api.nanobananai.com/v1beta/models/gemini-2.5-flash-image:generateContent

请求示例 (cURL)

curl -X POST \
  'https://api.nanobananai.com/v1beta/models/gemini-2.5-flash-image: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": "1:1"}
    }
  }'

关键参数说明

generationConfig.imageConfig.aspectRatio

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

支持的比例值：

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

在线交互体验 (Live Demo)