Gemini 图片生成（generateContent）

使用 Gemini 原生 generateContent 协议生成图片。

请求地址：POST https://api.frimodel.com/v1beta/models/{model}:generateContent

把 {model} 替换为图片模型 ID。实测可使用：

gemini-3.1-flash-image-preview

gemini-3-pro-image-preview

请求 Body

contents：消息数组，文本提示词放在 parts[].text。

generationConfig.responseModalities：图片生成应包含 IMAGE。

generationConfig.imageConfig.aspectRatio：图片比例，例如 1:1。

generationConfig.imageConfig.imageSize：目标尺寸，例如 1K、2K 或 4K，以当前模型能力为准。

最小示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "生成一个白色背景上的红色方块，不要文字"}
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

成功响应

图片：candidates[0].content.parts[].inlineData.data

图片格式：inlineData.mimeType

Token 用量：usageMetadata

实测返回 HTTP 200、image/jpeg，文件尺寸为 1024×1024。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

成功时返回 candidates 数组。图片 Base64 位于 content.parts[].inlineData.data。

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Hello"
                    }
                ]
            }
        }
    ]
}

Gemini 图片生成（generateContent）

请求参数

请求示例代码

返回响应