generateContent(Gemini 原生)

POST

/v1beta/models/{model}:{action}

Gemini 原生协议,path 含模型名与动作,如 gemini-3-pro:generateContent。请求体 contents(parts 数组)。其余参数遵循 Google 官方规范。模型名以平台实际开通为准,可调 GET /v1/models 查询。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

API Key

在 header 添加参数

x-api-key

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "你好"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-3-pro:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "你好"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

成功。响应遵循 Gemini 官方规范;流式动作(streamGenerateContent)返回 SSE。

该响应没有 Body

修改于 2026-07-22 01:21:43

gemini-omni-flash-preview 接口使用文档

gemini-3.8-flash