文本 / Gemini / Grok / DeepSeek
Gemini Pro
Gemini 文本模型分组(3.1 Pro、3 Flash、3.1 Flash Lite、3.6 / 3.7 / 3.8 Flash 及 2.5 Flash 系列),按 Token 计费,分组倍率 0.3。使用 Gemini 原生 generateContent 协议,模型名写在 URL 中。gemini-3.1-pro 整次请求超过 200K token 时按长上下文价计费。
分组 #152「【文本模型】Gemini Pro」 · Key 需属于该分组
多轮对话Gemini 原生按 Token 计费缓存计价
价格—
24 小时成功率—
最近 24 小时
可用模型
| 模型 | 说明 | 价格 |
|---|---|---|
gemini-2.5-flash | 每 1M token 基础价:输入 $0.3 / 输出 $2.5 / 缓存读 $0.03 | — |
gemini-2.5-flash-lite | 每 1M token 基础价:输入 $0.1 / 输出 $0.4 / 缓存读 $0.01 | — |
gemini-3-flash | 每 1M token 基础价:输入 $0.5 / 输出 $3 / 缓存读 $0.05 | — |
gemini-3.1-flash-lite | 每 1M token 基础价:输入 $0.25 / 输出 $1.5 / 缓存读 $0.025 | — |
gemini-3.1-flash-lite-preview | 每 1M token 基础价:输入 $0.25 / 输出 $1.5 / 缓存读 $0.025 | — |
gemini-3.1-pro | 每 1M token 基础价:输入 $2 / 输出 $12 / 缓存读 $0.2 / 缓存写 $2 | — |
gemini-3.6-flash | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.7-flash | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.8-flash | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.8-flash-high | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.8-flash-low | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.8-flash-medium | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
gemini-3.8-flash-tiered | 每 1M token 基础价:输入 $0.75 / 输出 $3.75 / 缓存读 $0.075 | — |
接口
POST /v1beta/models/{model}:generateContent | Gemini 原生生成,请求体为 contents;鉴权可用 x-goog-api-key |
GET /v1beta/models | Gemini 客户端获取当前 Key 的模型,请求头 x-goog-api-key |
GET /v1/models | 用同一把 Key 查询当前分组可用的完整模型名 |
能力与限制
| 计费方式 | 按 Token:实付 = 模型广场基础价 × 分组倍率 0.3 |
| 长上下文 | gemini-3.1-pro 整次请求超过 200K token 时:输入、缓存 ×2,输出 ×1.5(模型广场分档价) |
| Gemini Host | https://yyds.seqnode.com(客户端要求完整前缀时填 https://yyds.seqnode.com/v1beta) |
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
contents | array | 必填 | 对话内容,如 [{"role": "user", "parts": [{"text": "…"}]}] |
contents[].parts[].text | string | 必填 | 用户输入文本 |
注意事项
- 模型名写在请求 URL 中,不放进 JSON。
- Gemini 原生鉴权可用 x-goog-api-key 请求头,也可用 Authorization: Bearer。
- Gemini 客户端 Base URL 通常填 https://yyds.seqnode.com,避免重复拼接 /v1beta。
- 每把 Key 只绑定一个分组;用同一把 Key 调 GET /v1/models 确认可用的完整模型名。
- 模型广场显示的是基础价,实际扣费按分组倍率折算,以使用记录为准。
常见错误
| 返回 | 原因与处理 |
|---|---|
401 / 403 | Key 错误、已禁用或未绑定该分组;检查 Authorization: Bearer 请求头、绑定分组和访问权限。 |
模型广场有模型,Key 却调不到 | 模型广场包含多个分组;用这把 Key 调 GET /v1/models,核对完整模型名。 |
400 / 404 | 检查路径、JSON 字段和参数大小写,避免重复拼接 /v1。 |
429 | 并发、频率或上游容量限制;按 Retry-After 指数退避,并限制并发。 |
5xx / 超时 | 上游或网关临时问题;保存请求 ID,短暂退避后重试,持续出现时提供请求时间和 ID。 |