Gemini 3.1 Pro Preview — API 价格与接入指南

如何选择这个模型

以下为 Y-API 的选型建议与评估方法，不是已经完成的实测结论。

适合从这些任务开始

可用于跨多个工具、需要模型在它们之间保持计划连贯的软件工程与 Agent 任务，或代码与图表、文档混在一起的问题。

选择前需要注意

Preview 状态意味着行为可能不伴随版本号变更就改变，所以保存下来的评测结果绑定在你运行它的那一天。prompt 超过 20 万 token 后标价翻倍，这对大文档工作流影响很大。

模型规格

以下是 OpenRouter 的模型级规格快照，不是 Y-API 的兼容性实测。具体路由可接受的输入格式、参数和 token 上限可能更少。上线前请用小请求验证所需能力；文本请求成功不等于看图或工具调用已经验证。

上下文窗口: 1,048,576 tokens
输入: 文本 · 图片 · 文件 · 音频 · 视频
输出: 文本
OpenRouter 收录日期: 2026年2月19日
OpenRouter 列出的参数: include_reasoningmax_tokensreasoningreasoning_effortresponse_formatseedstopstructured_outputstemperaturetool_choicetoolstop_p

OpenRouter 模型页与规格

API 价格与成本估算

预计消耗额度: US$9.50
预计折合实付: US$0.95

这是示例用量预算，不是实测用量或报价承诺。包含输入和输出，不含单独的媒体收费、缓存优惠及重试；若推理 tokens 计费，也应计入输出预算。实际扣费以服务返回的用量为准。

充值 $1 获得 $10 额度。折合实付 = 消耗额度 ÷ 10，不是模型发布方的官方报价。

相同用量下的模型成本
模型	预计消耗额度	预计折合实付
Gemini 3.1 Pro Preview	US$9.50	US$0.95
Gemini 3.8 Flash	US$5.25	US$0.525
Claude Opus 5	US$17.50	US$1.75

查看大模型 API 价格与计费

API 接入示例

示例使用 Y-API 的完整模型 ID，仅发送文本，不代表图片、音频、视频、文件或工具能力已经验证。输出上限还需给推理过程留空间；若正文为空且 finish_reason=length，可能是预算已耗尽。

可以先试的任务

这里有一份失败的构建日志和它读取的配置文件。指出是哪个设置造成的，以及你会改什么，并引用具体那一行。

将控制台创建的密钥写入环境变量 TOKEN，在本地或服务端运行。不要把密钥放进浏览器代码或公开仓库。

cURL · Gemini 3.1 Pro Preview

curl --fail-with-body --silent --show-error --max-time 120 \
  'https://api.y-api.bestvirtualgoods.com/v1/chat/completions' \
  -H "Authorization: Bearer ${TOKEN:?Set TOKEN first}" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "model": "google/gemini-3.1-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "这里有一份失败的构建日志和它读取的配置文件。指出是哪个设置造成的，以及你会改什么，并引用具体那一行。"
    }
  ],
  "max_tokens": 4096
}
JSON