图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度

企业版环境

https://ee.nicerouter.com

POST

/v1beta/models/gemini-3-pro-image-preview:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing

协议说明：请求与响应按 Google Gemini 原生 GenerateContent REST 协议描述。NiceRouter 仅转发上游实际支持的字段；模型、渠道和预览版本可能忽略或拒绝部分生成参数、工具、思考、图像或语音配置。思考摘要通过 parts[].thought 标识，thoughtSignature 为不透明状态，函数调用多轮中必须原样回传，客户端不得依赖思考内容必然存在。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功

application/json

成功响应。非流式返回一个 GenerateContentResponse；streamGenerateContent 返回该对象的流式序列，字段可分散在多个块中。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://ee.nicerouter.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张未来城市中的飞行小猪插画。"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}'

响应示例

{"candidates":[{"content":{"role":"model","parts":[{"text":"最终回答"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":5,"candidatesTokenCount":3,"totalTokenCount":8}}

修改于 2026-07-20 09:57:25

google search

TTS 文本转语音