图片生成-调用谷歌搜搜

POST

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

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

Body 参数application/json

示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "一个透明涤纶材质旅行背包造型的创意微缩场景，背包正面刺绣立体书法字 “哈尔滨”，英文地名“Harbin”环绕包带，背包内部完全透明，展示城市真实的特色元素缩影，有圣•索菲亚教堂、哈尔滨伏尔加庄园、哈尔滨中央大街、黑龙江省广播电视塔龙塔、哈尔滨冰雪大世界、哈尔滨音乐厅等。整体风格 3D 渲染，具有梦幻感，使用 3D 建模软件如 Blender 或 C4D 制作，材质设置上注重光泽感，打光营造出柔和氛围，超详细，高清，HDR，电影般的构图，强调梦幻和未来感的美学，真实的纹理和光线增强了城市景观的真实性，简洁梦幻的纯色背景。参考图片样式"
        },
        // {
        //   "inlineData": {
        //     "mimeType": "image/png",
        //     "data": ""
        //   }
        // },
        // {
        //   "inlineData": {
        //     "mimeType": "image/png",
        //     "data": "参考图2图片base64"
        //   }
        // },
        // {
        //   "inlineData": {
        //     "mimeType": "image/jpeg",
        //     "data": ""
        //   }
        // }
      ],
    //   "tools": [
    // {
    //   "googleSearch": {}
    // }
  // ],
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "9:16",
      "imageSize": "2K"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api.banbenku.vip/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": "一个透明涤纶材质旅行背包造型的创意微缩场景，背包正面刺绣立体书法字 “哈尔滨”，英文地名“Harbin”环绕包带，背包内部完全透明，展示城市真实的特色元素缩影，有圣•索菲亚教堂、哈尔滨伏尔加庄园、哈尔滨中央大街、黑龙江省广播电视塔龙塔、哈尔滨冰雪大世界、哈尔滨音乐厅等。整体风格 3D 渲染，具有梦幻感，使用 3D 建模软件如 Blender 或 C4D 制作，材质设置上注重光泽感，打光营造出柔和氛围，超详细，高清，HDR，电影般的构图，强调梦幻和未来感的美学，真实的纹理和光线增强了城市景观的真实性，简洁梦幻的纯色背景。参考图片样式"
        },
        // {
        //   "inlineData": {
        //     "mimeType": "image/png",
        //     "data": ""
        //   }
        // },
        // {
        //   "inlineData": {
        //     "mimeType": "image/png",
        //     "data": "参考图2图片base64"
        //   }
        // },
        // {
        //   "inlineData": {
        //     "mimeType": "image/jpeg",
        //     "data": ""
        //   }
        // }
      ],
    //   "tools": [
    // {
    //   "googleSearch": {}
    // }
  // ],
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "9:16",
      "imageSize": "2K"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "thoughtSignature": "Et33egrZ93oBcsjafOWGnlG5pZy12cZkScwV3XxqrI1vgD9Ik1PeSCi4OiFn1vEj8Y8bRgAtlxSdOtHhXBmCQhet....省略的base64编码应该是思考过程没有用",
                        "inlineData": {
                            "mimeType": "image/jpeg",
                            "data": "/9j/4AAQSkZJRgABAQEBLAEsAAD/6xdnSlAAAQAAAAEAABdda....省略的图片base64编码"
                        }
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": null
        }
    ],
    "promptFeedback": {
        "safetyRatings": null
    },
    "usageMetadata": {
        "promptTokenCount": 9,
        "candidatesTokenCount": 1289,
        "totalTokenCount": 1505,
        "thoughtsTokenCount": 207,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 9
            }
        ]
    },
    "modelVersion": "gemini-3-pro-image-preview"
}

修改于 2026-01-15 13:51:25

PDF支持 [原生格式] base64格式

文本生成