Gemini 3.1 Pro Preview Chat API

google/gemini-3.1-pro-preview

1M tokens · 输入 160 / 输出 960 积分 / 1M tokens

Gemini 3.1 Pro Preview Chat 将文本和多模态素材转化为分析、代码与回答，支持 100 万 token 上下文和可调推理深度。提供目标、源资料与验收标准，即可围绕证据组织结果。

Gemini 3.1 Pro Preview

Google · chat-completions

与 Gemini 3.1 Pro Preview 开始对话

每个模型都有独立对话。切换模型不会发送其他模型的聊天记录，切回后可继续原对话。请求按实际 Token 用量计费。

同步 LLM API

快速开始

向 /v1/chat/completions 发送 POST 请求，使用 google/gemini-3.1-pro-preview 获取生成结果与用量；stream 可选择 JSON 或 SSE。

Endpoint: POST /v1/chat/completions
Model ID: google/gemini-3.1-pro-preview
Protocol: Chat Completions

请求字段

字段	要求	说明
model	必填	google/gemini-3.1-pro-preview
messages	必填	非空对话消息数组。
max_tokens	可选	限制本次响应的输出 token 数。
temperature	可选	采样温度，体验区可设置 0–2。
top_p	可选	核采样概率，体验区可设置 0–1。
stream	可选	设为 true 时返回 SSE 事件流。

返回与用量

成功响应包含生成内容和 usage。系统按实际输入、输出与缓存 token 结算。

流式响应

设置 stream: true 可读取 SSE；流结束后再从最终用量事件完成统计。

查看协议文档

curl --request POST \
  --url https://api.vidgo.ai/v1/chat/completions \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "google/gemini-3.1-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "Explain why deterministic retries matter in distributed systems."
    }
  ],
  "max_tokens": 1024,
  "temperature": 1,
  "top_p": 1,
  "stream": false
}'

服务端保存 API Key。不要把密钥放入浏览器代码或公开仓库。

继续体验

Gemini 3.7 Flash Gemini 3.5 Flash Gemini 3 Flash Preview

Gemini 3.1 Pro Preview Chat

Gemini 3.1 Pro Preview 是 Google Gemini 3 系列中用于复杂推理、编程和多模态分析的模型。100 万 token 上下文窗口可容纳文件、文档和对话记录，推理深度配置可按任务复杂度调整。Vidgo 提供 Chat Completions 与 Gemini Native 两种调用格式，返回 JSON 或 SSE 事件流。

为什么选择 Gemini 3.1 Pro Preview？

复杂推理综合关联约束和证据，形成结构清晰的详细回答。
多步骤编程结合需求、源文件和工具结果规划并检查代码任务。
长上下文分析在 100 万 token 上下文中对照相关报告或代码文件。
多模态理解分析任务时，将文字与图像等媒体内容联系起来。

参数

参数	要求	说明
model	Chat Completions 必填	使用 google/gemini-3.1-pro-preview。
messages	Chat Completions 必填	非空对话消息数组。
contents	Gemini Native 必填	包含 role 与 parts 的非空对话数组；模型 ID 写在 URL 中。
contents[].parts[].inlineData	Gemini Native 可选	与文本片段一起提交的媒体数据，包含 mimeType 和 Base64 data。
generationConfig	Gemini Native 可选	设置 temperature、topP、topK、maxOutputTokens 或 stopSequences。
safetySettings	Gemini Native 可选	本次请求的安全设置。
stream	Chat Completions 可选	设为 true 时接收 SSE 响应。默认`falsetrue`

如何使用

定义问题说明希望得到的结论、交付内容与验收标准。
提供相关证据加入推理所需的源文本、代码、文档或媒体素材。
选择 API 格式Chat Completions 提交 messages；Gemini Native 提交 contents。
审阅结果检查回答与 token 用量，再提供后续指令或新证据。

价格

输入与输出 token 分开计费；下列费率均按每 100 万 tokens 计算。

用量	费率	说明
输入	$0.80 · 160 credits / 1M tokens	请求中的输入 tokens。
输出	$4.80 · 960 credits / 1M tokens	响应中的生成 tokens，包括用量记录中的推理 tokens。

适用场景

多步骤编程根据需求和测试结果规划并检查代码修改。
研究资料整合对照长报告，将结论关联到提交的证据。
多模态分析结合视觉资料与文字问题，聚焦需要解释的细节。

使用建议

在同一次请求中提供目标结果、约束和必要的源资料。
审阅长上下文时，请求将结论关联到具体段落或文件。
估算 token 费用时，查看 usageMetadata 或 Chat Completions 的 usage。

使用说明

上下文窗口为 100 万 tokens。
本页体验区的输出控制范围为 256–8,192 tokens。
Chat Completions 的 model 字段及 Gemini Native 的模型 URL 均使用 google/gemini-3.1-pro-preview。

Gemini 3.1 Pro Preview Chat API 常见问题

Gemini 3.1 Pro Preview Chat API 是什么？

Gemini 3.1 Pro Preview 是 Google Gemini 3 系列中用于复杂推理、编程及多模态分析的模型。它将文本和媒体上下文转化为详细回答、代码与结构化结论，具备 100 万 token 上下文窗口。可按任务设置推理深度，并通过 Chat Completions、Gemini Native 或本页体验区调用。

Gemini 3.1 Pro Preview 如何辅助编程？

提供目标、相关源文件、约束和测试结果，并要求模型结合证据规划修改步骤、检查输出与需求是否一致。

Gemini 3.1 Pro Preview 能分析多少上下文？

它的上下文窗口为 100 万 tokens。将回答具体问题所需的文档、代码和对话记录组织在请求中。

如何向 Gemini 3.1 Pro Preview 提交多模态内容？

在 Gemini Native 的 contents 中同时使用文本与 inlineData 片段；媒体片段提供 mimeType 和 Base64 data，并用文本说明分析目标。

如何获取 Gemini 3.1 Pro Preview 的流式响应？

Chat Completions 将 stream 设为 true；Gemini Native 调用 streamGenerateContent?alt=sse。按顺序读取 SSE 事件，并查看 usageMetadata 中的 token 用量。

Gemini 3.1 Pro Preview 在 Vidgo AI 的价格是多少？

每 100 万输入 tokens 收取 160 credits（$0.80），每 100 万输出 tokens 收取 960 credits（$4.80）。可根据响应中的 token 用量和上方价格表核对费用。