文本生成 + 思考

企业版环境

https://ee.nicerouter.com

POST

/v1beta/models/gemini-2.5-pro:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

协议说明：请求与响应按 Google Gemini 原生 GenerateContent REST 协议描述。NiceRouter 仅转发上游实际支持的字段；模型、渠道和预览版本可能忽略或拒绝部分生成参数、工具、思考、图像或语音配置。思考摘要通过 parts[].thought 标识，thoughtSignature 为不透明状态，函数调用多轮中必须原样回传，客户端不得依赖思考内容必然存在。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功

application/json

成功响应。非流式返回一个 GenerateContentResponse；streamGenerateContent 返回该对象的流式序列，字段可分散在多个块中。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://ee.nicerouter.com/v1beta/models/gemini-2.5-pro:generateContent?key={{YOUR_API_KEY}}' \
--header 'x-goog-api-key: {{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "用一句话解释量子纠缠。"
        }
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "thinkingConfig": {
      "includeThoughts": true,
      "thinkingBudget": -1
    }
  }
}'

响应示例

{"candidates":[{"content":{"role":"model","parts":[{"text":"最终回答"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":5,"candidatesTokenCount":3,"totalTokenCount":8}}

修改于 2026-07-20 09:57:23

文本合成

文本生成-流