1. Gemini v1beta
梧柏API使用文档
WHBAI · Google Gemini 原生
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Gemini v1beta
    • Gemini 原生内容生成
      POST
    • 视频理解-url [原生格式] 开发中
      POST
    • 文本生成-流
      POST
    • 文本生成+思考-流
      POST
    • 图片生成
      POST
    • 图片生成 gemini-2.5-flash-image 控制宽高比
      POST
    • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      POST
    • 图片编辑
      POST
    • 谷歌联网搜索
      POST
    • TTS 文本转语音
      POST
    • 文本生成 gemini-3-pro-preview:generateContent
      POST
    • Imagen 生成图片
      POST
    • Imagen 4 开发中
      POST
    • gemini-tts文本转语音
      POST
    • 文本嵌入
      POST
    • gemini-3.1-flash-lite-image
      POST
  • 数据模型
    • PostV1betaModelsModeNameGenerateContentRequest
    • PostV1betaModelsGemini25FlashImageGenerateContentRequest
    • PostV1betaModelsGemini3ProImagePreviewGenerateContentRequest
    • PostV1betaModelsGemini20FlashExpImageGenerationGenerateContentRequest
    • PostV1betaModelsGemini25FlashPreviewTtsGenerateContentRequest
    • PostV1betaModelsImagen40UltraGenerate001PredictRequest
    • PostV1betaModelsImagen40Generate001PredictRequest
    • PostV1betaModelsGemini25ProPreviewTtsGenerateContentRequest
    • PostV1betaModelsGeminiEmbedding001EmbedContentRequest
    • Gemini 3.1 Flash-Lite Image generateContent Request
    • PostV1betaModelsGemini31FlashLiteImageGenerateContentResponse
    • NewApiError
  1. Gemini v1beta

图片生成 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

网站中的模型与调用示例#

图片生成 gemini-2.5-flash-image#

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

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "items": {
        "properties": {
          "parts": {
            "items": {
              "properties": {
                "inline_data": {
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "mime_type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "mime_type",
                    "data"
                  ],
                  "type": "object"
                },
                "text": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "generationConfig": {
      "properties": {
        "responseModalities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "responseModalities"
      ],
      "type": "object"
    },
    "response_format": {
      "description": "填url返回url，不填默认base64",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Fill in the url and return the url, if not fill in the default base64"
        }
      }
    }
  },
  "required": [
    "contents",
    "generationConfig"
  ]
}

请求示例 · 图片生成 gemini-2.5-flash-image#

源文档已省略示例内容。

请求示例 · 图片生成 gemini-2.5-flash-image 控制宽高比#

源文档已省略示例内容。

图片生成 gemini-2.5-flash-image#

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

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "items": {
        "properties": {
          "parts": {
            "items": {
              "properties": {
                "inline_data": {
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "mime_type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "mime_type",
                    "data"
                  ],
                  "type": "object"
                },
                "text": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "generationConfig": {
      "properties": {
        "responseModalities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "responseModalities"
      ],
      "type": "object"
    },
    "response_format": {
      "description": "填url返回url，不填默认base64",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Fill in the url and return the url, if not fill in the default base64"
        }
      }
    }
  },
  "required": [
    "contents",
    "generationConfig"
  ]
}

请求示例 · 图片生成 gemini-2.5-flash-image#

源文档已省略示例内容。

请求示例 · 图片生成 gemini-2.5-flash-image 控制宽高比#

源文档已省略示例内容。

图片生成 gemini-2.5-flash-image#

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

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "items": {
        "properties": {
          "parts": {
            "items": {
              "properties": {
                "inline_data": {
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "mime_type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "mime_type",
                    "data"
                  ],
                  "type": "object"
                },
                "text": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "generationConfig": {
      "properties": {
        "responseModalities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "responseModalities"
      ],
      "type": "object"
    },
    "response_format": {
      "description": "填url返回url，不填默认base64",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Fill in the url and return the url, if not fill in the default base64"
        }
      }
    }
  },
  "required": [
    "contents",
    "generationConfig"
  ]
}

请求示例 · 图片生成 gemini-2.5-flash-image#

源文档已省略示例内容。

请求示例 · 图片生成 gemini-2.5-flash-image 控制宽高比#

源文档已省略示例内容。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
or
Query 参数

Header 参数

Body 参数application/json

示例
{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "'Hi, This is a picture of me. Can you add a llama next to me"
                },
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA..."
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9"
        }
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff '/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": "'\''Hi, This is a picture of me. Can you add a llama next to me"
                },
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA..."
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9"
        }
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "id": "resp_example",
    "object": "response",
    "status": "completed"
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:06
上一页
图片生成
下一页
图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
Built with