查看 Gemini 官方模型页。
https://ai.google.dev/gemini-api/docs/models正在准备内容，请稍候。
正在切换页面...
网络较慢时会保留当前状态，直到新页面准备完成。
这里保留 Gemini 官方入口、当前模型族和 TokenAI 的模型目录维护建议。
Gemini 原生 REST 用 `x-goog-api-key` 传 API Key。模型目录维护先打 `/models`，必要时再补一次 `generateContent` 校验真实可用性。
查看 Gemini 官方模型页。
https://ai.google.dev/gemini-api/docs/models查看 REST API 参考和请求体说明。
https://ai.google.dev/gemini-api/docs/api-reference查看如何创建和管理 Gemini API Key。
https://ai.google.dev/gemini-api/docs/api-key这些是当前模型目录里最值得优先保留的 Gemini 模型名。
| 模型 | 用途 |
|---|---|
| byt-gemini-3-pro-preview | 最新旗舰预览档位 |
| byt-gemini-2.5-pro | 主线高质量通用模型 |
| byt-gemini-2.5-flash | 更低延迟与更低成本的通用模型 |
| byt-gemini-2.5-flash-lite | 轻量、低成本场景 |
| byt-gemini-2.0-flash | 较早一代的通用模型 |
读取可用模型列表。模型目录维护会先依赖它确认 Key 是否有效。
Gemini 原生生成入口。需要额外校验时可用它发一条最短请求。
Gemini 原生鉴权头。服务端建议只把 Key 留在渠道配置里。
curl "https://generativelanguage.googleapis.com/v1beta/models" \ -H "x-goog-api-key: $GEMINI_API_KEY"
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-pro:generateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
"contents": [
{
"role": "user",
"parts": [{ "text": "Hello Gemini" }]
}
]
}'如果渠道里已经配了可用 API Key，`job-worker` 会先拉取实际可见模型，再补上官方文档里的模型目录。