Gemini 3.1 Pro Preview
查看 Gemini 3.1 Pro Preview 在 U-Token 通用币 中的模型 ID、调用端点、请求参数和响应示例。
Gemini 3.1 Pro Preview 是 U-Token 通用币 模型目录中的对话模型。本文只描述网关已确认的协议、端点和模型 ID;上下文长度、视觉、工具、推理及 JSON 能力以当前上游和实际响应为准。
模型信息
| 项目 | 值 |
|---|---|
| 协议 | Google generateContent |
| 端点 | POST /v1/models/{model}:generateContent |
| 可用性 | 以当前 API Key 的 GET /v1/models 返回为准 |
| 价格 | 以控制台价格页和账号系数为准 |
模型 ID
| 模型 ID | 说明 |
|---|---|
gemini-3.1-pro-preview | 当前 API Key 的模型列表返回时使用该 ID |
不要仅根据本页假设模型已对你的账号开放。发起请求前请查询 GET /v1/models,并使用响应中原样返回的模型 ID、endpoint 和可选的 responses_endpoint。
核心请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
model | 是 | 使用上表中且由模型列表返回的 ID |
contents | 是 | Google contents / parts 内容 |
generationConfig.maxOutputTokens | 否 | 限制模型输出长度 |
generationConfig.temperature | 否 | 采样参数,合法范围以当前上游为准 |
:streamGenerateContent | 否 | 需要流式输出时,将 URL 方法后缀改为 :streamGenerateContent |
请求示例
curl "https://u-token.ai/v1/models/gemini-3.1-pro-preview:generateContent" \
-H "Authorization: Bearer sk-你的KEY" \
-H "content-type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"用一句话介绍这个模型。"}]}],
"generationConfig":{"maxOutputTokens":1500}}'上面的示例使用 Authorization: Bearer。同一把平台 Key 也可以放在 x-goog-api-key 或查询参数 key 里,路径仍是 /v1/models/{model}:generateContent。这里不提供 Google 的 /v1beta 路径。模型 ID 以当前 Key 的 GET /v1/models 为准。鉴权细节见 Gemini 格式。
响应示例
以下仅展示协议结构,文本、Token 数以及 id、model 等附加字段以实际响应为准。
{
"candidates": [
{
"content": {
"role": "model",
"parts": [{ "text": "这是一个通过 Google generateContent 协议调用的对话模型。" }]
},
"finishReason": "STOP"
}
],
"usageMetadata": { "promptTokenCount": 8, "candidatesTokenCount": 20, "totalTokenCount": 28 }
}网关原样透传对应协议的响应和流式事件。完整协议规则请查看 Gemini 格式。
