- 开放平台说明，必看
- 激活码兑换教程
- 错误码说明
- 开放平台常识
- 视频模型
- 绘图模型
- 对话模型
- 所有对话模型均兼容 OpenAI 格式
- Chat(分析视频)
- Chat(分析图片)
- 聊天(Chat)
- Anthropic Claude 接口
- 谷歌Gemini 接口
- 原生格式
- 文本生成POST
- 文本生成-流 POST
- 文本生成+思考-流 POST
- 图片生成POST
- 图片生成 gemini-2.5-flash-imagePOST
- 图片生成 gemini-2.5-flash-image 控制宽高比POST
- 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度POST
- 图片编辑 POST
- 图片理解POST
- 格式化输出POST
- 函数调用POST
- 文档理解POST
- URL context [原生格式] POST
- 代码执行POST
- google searchPOST
- 视频理解POST
- URL contextPOST
- 音频理解POST
- EmbeddingsPOST
- TTS 文本转语音POST
- 文本生成 gemini-3-pro-preview:generateContentPOST
- Imagen 生成图片POST
- gemini-tts文本转语音POST
- 文本嵌入POST
- 文本生成
- chat兼容格式
- ChatGpt 接口
- 常见问题
- Tools
图片生成 gemini-2.5-flash-image 控制宽高比
POST
/v1beta/models/gemini-2.5-flash-image:generateContent
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************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": "iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIAAABm4BptAAAAiXpUWHRSYXcgcHJvZmlsZSB0eXBlIGlwdGMAAAiZTYwxDgIxDAT7vOKekDjrtV1T0VHwgbtcIiEhgfh/QaDgmGlWW0w6X66n5fl6jNu9p+ULkapDENgzpj+Kl5aFfa6KnYWgSjZjGOiSYRxTY/v8KIijI/rXyc236kHdAK22RvHVummEN+91ML0BQ+siou79WmMAAAKHaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA1LjUuMCI+IDxyZGY6UkRGIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyI+IDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOklwdGM0eG1wRXh0PSJodHRwOi8vaXB0Yy5vcmcvc3RkL0lwdGM0eG1wRXh0LzIwMDgtMDItMjkvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIElwdGM0eG1wRXh0OkRpZ2l0YWxTb3VyY2VGaWxlVHlwZT0iaHR0cDovL2N2LmlwdGMub3JnL25ld3Njb2Rlcy9kaWdpdGFsc291cmNldHlwZS90cmFpbmVkQWxnb3JpdGhtaWNNZWRpYSIgSXB0YzR4bXBFeHQ6RGlnaXRhbFNvdXJjZVR5cGU9Imh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWEiIHBob3Rvc2hvcDpDcmVkaXQ9Ik1hZGUgd2l0aCBHb29nbGUgQUkiLz4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gICA8P3hwYWNrZXQgZW5kPSJ3Ij8+fxJoawAAIABJREFUeJysvdmOZEmSJXaOmrlHZORSVaxuYgZoYvgy/DgCA34nB+ArHwiSwEyj2cPuWjMzNnc3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请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/v1beta/models/gemini-2.5-flash-image:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"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": "iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIAAABm4BptAAAAiXpUWHRSYXcgcHJvZmlsZSB0eXBlIGlwdGMAAAiZTYwxDgIxDAT7vOKekDjrtV1T0VHwgbtcIiEhgfh/QaDgmGlWW0w6X66n5fl6jNu9p+ULkapDENgzpj+Kl5aFfa6KnYWgSjZjGOiSYRxTY/v8KIijI/rXyc236kHdAK22RvHVummEN+91ML0BQ+siou79WmMAAAKHaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA1LjUuMCI+IDxyZGY6UkRGIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyI+IDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOklwdGM0eG1wRXh0PSJodHRwOi8vaXB0Yy5vcmcvc3RkL0lwdGM0eG1wRXh0LzIwMDgtMDItMjkvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIElwdGM0eG1wRXh0OkRpZ2l0YWxTb3VyY2VGaWxlVHlwZT0iaHR0cDovL2N2LmlwdGMub3JnL25ld3Njb2Rlcy9kaWdpdGFsc291cmNldHlwZS90cmFpbmVkQWxnb3JpdGhtaWNNZWRpYSIgSXB0YzR4bXBFeHQ6RGlnaXRhbFNvdXJjZVR5cGU9Imh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWEiIHBob3Rvc2hvcDpDcmVkaXQ9Ik1hZGUgd2l0aCBHb29nbGUgQUkiLz4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gICA8P3hwYWNrZXQgZW5kPSJ3Ij8+fxJoawAAIABJREFUeJysvdmOZEmSJXaOmrlHZORSVaxuYgZoYvgy/DgCA34nB+ArHwiSwEyj2cPuWjMzNnc3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返回响应
🟢200成功
application/json
Body
示例
{}修改于 2026-03-08 01:18:40