ZeoAPIZeoAPI API 文档与接入指南
getting-started

Nanobanana2绘图

一、Gemini 原生请求格式

示例请求

curl -X POST 'https://www.zeoapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent' \
--header 'Content-Type: application/json' \
--header 'X-Goog-Api-Key: <你的许可证>' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "画小猫"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": ["TEXT", "IMAGE"],
        "imageConfig": {
            "aspectRatio": "3:4",
            "imageSize": "4k"
        }
    }
}'

核心参数讲解

🎯 控制画面比例:aspectRatio

"aspectRatio": "3:4"
  • 控制图片的宽高比例
  • 决定是横图、竖图还是方图

常见比例:

  • 1:1 → 方图(头像、图标)
  • 3:4 → 竖图(人物)
  • 4:3 → 横图(风景)
  • 16:9 → 宽屏(壁纸、封面)

支持的所有比例:1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9


🎯 控制画面质量:imageSize

"imageSize": "4k"
  • 控制图片清晰度(分辨率等级)

常见选择:

  • 1k → 低清
  • 2k → 中等
  • 4k → 高清

✅ Gemini 重点总结

  • aspectRatio → 控制画面比例
  • imageSize → 控制画面质量

二、OpenAI 请求格式

示例请求

curl -X POST 'https://www.zeoapi.com/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <你的许可证>' \
--data-raw '{
    "messages": [
        {
            "role": "user",
            "content": "画只猫"
        }
    ],
  "model": "gemini-3.1-flash-image-preview",
  "stream": true,
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "4:3",
        "image_size": "4k"
      }
    }
  }
}'

核心参数讲解

🎯 控制画面比例:aspect_ratio

"aspect_ratio": "4:3"
  • 和 Gemini 的 aspectRatio 完全一样

🎯 控制画面质量:image_size

"image_size": "4k"
  • 和 Gemini 的 imageSize 完全一样

✅ OpenAI 重点总结

  • aspect_ratio → 控制画面比例
  • image_size → 控制画面质量

三、参数对照表

功能Gemini 原生OpenAI 格式
画面比例aspectRatioaspect_ratio
画面质量imageSizeimage_size

四、一句话总结

👉 比例决定形状,质量决定清晰度

  • aspectRatio / aspect_ratio → 画面比例
  • imageSize / image_size → 画面质量

五、推荐参数组合

人物插画

"aspectRatio": "3:4",
"imageSize": "4k"

风景图

"aspectRatio": "4:3",
"imageSize": "4k"

壁纸

"aspectRatio": "16:9",
"imageSize": "4k"

头像

"aspectRatio": "1:1",
"imageSize": "2k"