使用 Gemini 2.5 Flash Image 生成内容

POST

/v1beta/models/gemini-2.5-flash-image:generateContent

使用 Gemini 2.5 Flash Image（Nano Banana）模型生成图片。此模型针对速度和效率进行了优化，适合处理大批量、低延迟的任务，生成 1024 像素分辨率的图片。

功能特点

快速生成

最多接受 3 张图片作为输入

支持多种宽高比

适合大批量处理

使用场景

文本到图片生成

图片编辑（添加/移除元素）

风格迁移

多图片合成

请求参数

Authorization

API Key

在 header 添加参数

x-goog-api-key

示例：

x-goog-api-key: ********************

Body 参数application/json必填

根据文本描述生成图片

{
    "contents": [
        {
            "parts": [
                {
                    "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-2.5-flash-image:generateContent' \
--header 'x-goog-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
                }
            ]
        }
    ]
}'

返回响应

🟢200

application/json

成功生成内容

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
                        "inline_data": {
                            "mime_type": "image/jpeg",
                            "data": "<BASE64_IMAGE_DATA>"
                        },
                        "thought": true,
                        "thought_signature": "string"
                    }
                ]
            },
            "finishReason": "STOP",
            "safetyRatings": [
                {
                    "category": "HARM_CATEGORY_HARASSMENT",
                    "probability": "NEGLIGIBLE"
                }
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 100,
        "candidatesTokenCount": 1290,
        "totalTokenCount": 1390
    }
}

🟠400

🟠401

🟠429

🔴500

修改于 2025-12-29 09:13:47

纯官方格式教程必看

使用 Gemini 3 Pro Image Preview 生成内容