文本生成：gemini-3.1-pro-preview:generateContent

使用 generateContent 接口向 gemini-3.1-pro-preview 模型提交文本生成请求。该接口可用于单轮文本生成，也可通过传入多条对话内容实现多轮上下文交互。

请求地址

POST https://www.vortapapi.com/v1beta/models/gemini-3.1-pro-preview:generateContent

查询参数

参数名	类型	必填	说明
key	string	是	Vortap API Key，例如 sk-***。

请求头

名称	必填	说明
Content-Type	是	固定使用 application/json。

请求示例

curl "https://www.vortapapi.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请用简洁的语言介绍什么是 API 网关。"
          }
        ]
      }
    ]
  }'

多轮对话示例

curl "https://www.vortapapi.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "什么是向量数据库？"
          }
        ]
      },
      {
        "role": "model",
        "parts": [
          {
            "text": "向量数据库是一类用于存储、索引和检索向量表示的数据系统，常用于语义搜索、推荐和 RAG 场景。"
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "text": "它和普通关系型数据库有什么不同？"
          }
        ]
      }
    ]
  }'

常见请求字段

字段	类型	必填	说明
contents	array	是	对话内容列表，包含用户输入、模型回复等上下文消息。
contents[].role	string	否	消息角色，常见值包括 user 和 model。
contents[].parts	array	是	消息片段数组，可包含文本等内容。
contents[].parts[].text	string	是	文本内容。

响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "API 网关是位于客户端和后端服务之间的统一入口，用于转发请求、鉴权、限流、监控和协议适配等。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ]
}