接入指南

gemini-3.1-pro-preview · API 接入

通过gemini接口接入 gemini-3.1-pro-preview。包含请求示例、参数、鉴权和结果处理。

POST/v1beta/models/{model}:generateContent

官方对应 gemini-3.1-pro-preview核对 2026-09-27官方资料

接入流程从准备到第一次请求

创建密钥01
API_KEY
在控制台创建密钥，保存在服务端。
选择模型02
模型 ID + 原生协议
从实时目录核对模型和输入要求。
完成第一次调用03
请求 → 响应
复制对应模型的请求示例并读取结果。

API 模型 ID 为 gemini-3.1-pro-preview。本文说明平台的实际契约，调用前请核对实时目录中的可用性。

请求示例

平台地址在构建时填入，运行前设置 API_KEY 为服务端密钥。

curl "https://vip.astralgames.ai/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $API_KEY" \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how an HTTP request works in three concise steps."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 1024
  }
}'

协议与响应

此模型使用 gemini 协议，读取其原生响应及 usage 字段，不使用媒体任务的 input 包装。

支持的端点模板：

POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent
POST /v1/interactions
POST /v1beta/interactions

限制	目录值
上下文 Token	128000
最大输出 Token	16384

流式调用使用该协议的原生流式选项，并按协议解析事件；能力以实时目录为准。

官方来源与模型身份

核对日期: 2026-09-27 · 平台模型: gemini-3.1-pro-preview · 官方对应: gemini-3.1-pro-preview

计费与排错

接入时核对当前可用性、契约和账号价格。排错时保留请求 ID 与消费凭据。完整 API 参考