图片生成 gemini-2.5-flash-image 控制宽高比

POST

/v1beta/models/gemini-2.5-flash-image: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": "把goku的自拍的手机变成红色"
        },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "省略的图片base64编码"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "9:16"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api.banbenku.vip/v1beta/models/gemini-2.5-flash-image:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "把goku的自拍的手机变成红色"
        },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "省略的图片base64编码"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "9:16"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "好的，这是把悟空手机变成红色后的图片：\n "
                    },
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "省略的图片base64编码"
                        }
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": null
        }
    ],
    "promptFeedback": {
        "safetyRatings": null
    },
    "usageMetadata": {
        "promptTokenCount": 269,
        "candidatesTokenCount": 1303,
        "totalTokenCount": 1572,
        "thoughtsTokenCount": 0,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 11
            },
            {
                "modality": "IMAGE",
                "tokenCount": 258
            }
        ]
    },
    "modelVersion": "gemini-2.5-flash-image",
    "responseId": "bOhlabyeOqy0jrEPg4rHmQM"
}

修改于 2026-01-13 06:41:06

图片生成 gemini-2.5-flash-image

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