Gemini聊天接口 /api/v1beta/models/{model}:generateContent

POST

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

Gemini API 主入口，支持流式和非流式响应。
支持的模型：

gemini-2.5-flash (Flash 2.5)

gemini-2.5-flash-lite (Flash 2.5 Lite)

gemini-2.5-pro (Pro 2.5)

gemini-3-flash (Flash 3)

gemini-3-flash-preview (Flash 3 Preview)

gemini-3-pro-preview (Pro 3 Preview)

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

基础请求流式请求带 System Prompt多轮对话

{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好"}]
      }
    ],
    "generationConfig": {
      "maxOutputTokens": 8192
    }
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

基础请求流式请求带 System Prompt多轮对话

curl --location --request POST '/api/v1beta/models/gemini-2.5-flash:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好"}]
      }
    ],
    "generationConfig": {
      "maxOutputTokens": 8192
    }
  }'

返回响应

🟢200

application/json

成功响应

Body

示例

{
    "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
    "type": "message",
    "role": "assistant",
    "content": [
        {
            "type": "text",
            "text": "string"
        }
    ],
    "model": "claude-sonnet-4-20250514",
    "stop_reason": "end_turn",
    "usage": {
        "input_tokens": 25,
        "output_tokens": 150,
        "cache_read_input_tokens": 0,
        "cache_creation_input_tokens": 0
    }
}

🟠400

🟠401

🟠402

🟠429

🔴500

修改于 2026-02-09 13:18:13

Claude聊天接口 /v1/message

OpenAI 聊天接口 /api/gpt/v1/completions