跳转到主要内容
厂商： Google Model ID： gemini-3-1-pro 能力： 1M context · vision · audio in · tool use · streaming · structured output · grounding 价格： 按 token，pro 档（实时价格） Gemini 3.1 Pro 是 输入长度 和 模态组合 都重要时的正确选择。它接受 最多 1M token 输入 —— 足以容纳一份长 PDF、一段视频转录或一份图文混 合语料 —— 并在单次调用里对整体推理。纯文本的旗舰工作上 GPT-5.5 和 Claude Opus 4.8 旗鼓相当；Gemini 3.1 Pro 的优势在多模态 + 长上下文的 组合。

​
请求

curl https://llm.bytespike.ai/v1/chat/completions \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gemini-3-1-pro",
    "messages": [{"role": "user", "content": "Summarize the key claims in this 200-page filing."}]
  }'

​
Body 参数

字段类型是否必填默认说明
modelstring是—gemini-3-1-pro
messagesarray是—OpenAI chat 形状；支持 image_url 和 input_audio 块。
max_tokensinteger否model max最大：32768。
temperaturenumber否1.0—
toolsarray否—支持 function calling。
response_formatobject否—JSON / 结构化输出。
groundingobject否—Google Search grounding 工具 —— 按次计费。
streamboolean否falseSSE 流式。

​
响应

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gemini-3-1-pro",
  "choices": [{"index": 0, "message": {"role": "assistant", "content": "..."}, "finish_reason": "stop"}],
  "usage": {"prompt_tokens": 287430, "completion_tokens": 4218, "total_tokens": 291648}
}

​
代码示例

curl https://llm.bytespike.ai/v1/chat/completions \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gemini-3-1-pro", "messages": [{"role": "user", "content": "Summarize this filing."}]}'

​
Grounding（Google Search）

传 "grounding": {} 给模型一个内置的 Google Search 工具，用于事实 grounded 任务。按次计费；见 价格。 当问题需要可能在训练截止之后的最新信息时有用。

​
流式 + 缓存

"stream": true 走 SSE。自动 prompt caching —— 1M token prompt 上， 缓存命中是杠杆最高的成本优化。

​
错误

Code触发是否计费
400 / 401 / 402 / 422 / 429标准否
413输入超过 1M token否
5xx上游否（自动重试）

​
何时使用

  • 多模态长上下文工作（文本 + 图像 + 转录一起做）。
  • 200K 不够的长文档推理。
  • 纯文本旗舰工作，请比较 GPT-5.5 和 Claude Opus 4.8。
  • flash 档分类，见 Gemini 3 Flash。

​
限制

限制值
Context window1M tokens
Max output32768 tokens
支持 tool use是
支持 vision是
支持 audio 输入是
支持 streaming是
支持 prompt caching自动
支持 grounding（Google Search）是