Gemini 原生内容生成

POST

/v1beta/models/{model}:generateContent

使用 Gemini 原生 generateContent 格式生成文本或图片。模型名放在 URL 路径中，请求体内不再填写 model。文本位于 candidates[].content.parts[].text，生成图片位于 candidates[].content.parts[].inlineData.data，其值为 Base64。

当前没有单独启用的 Gemini 文本模型；调用纯文本 Gemini 模型前先通过 /v1/models 确认模型名。Gemini 图片模型可以同时返回说明文本和图片。

请求参数

Path 参数

Body 参数application/json必填

示例

Gemini 原生文本生成Gemini 文生图片Gemini Base64 图片编辑

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "解释 RAG 与微调的主要区别。"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 0.7,
        "maxOutputTokens": 1200,
        "thinkingConfig": {
            "thinkingBudget": 512,
            "includeThoughts": false
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Gemini 原生文本生成Gemini 文生图片Gemini Base64 图片编辑

curl --location '/v1beta/models/gemini-3.1-flash-image-preview:generateContent' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "解释 RAG 与微调的主要区别。"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 0.7,
        "maxOutputTokens": 1200,
        "thinkingConfig": {
            "thinkingBudget": 512,
            "includeThoughts": false
        }
    }
}'

返回响应

🟢200成功

application/json

Gemini 原生生成结果。图片返回在 inlineData.data，需按 inlineData.mimeType 解码保存。

Bodyapplication/json

示例

文本结果图片结果

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "RAG 在推理时检索外部资料，微调则改变模型参数。"
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 18,
        "candidatesTokenCount": 42,
        "totalTokenCount": 60
    }
}

🟠400请求有误

🟠401没有权限

🟠429

🔴500服务器错误

修改于 2026-08-11 12:29:51

创建 Responses 响应

Seedream 图片生成与编辑