OminiApi 文档

Gemini

Gemini 系列模型的可用模型、Gemini CLI 配置与常见问题

OminiApi Team模型使用约 8 分钟

Gemini 系列支持 Gemini 原生接口(/v1beta/models/{模型名}:generateContent),同时也能通过 Anthropic Messages、Chat Completions、Responses 调用,所以 Gemini CLI、Claude Code、Codex、Cherry Studio 都能用。

可用模型

模型名档位说明
gemini-3.1-pro-previewPro推荐作为主模型
gemini-3.8-flashFlash(快速)推荐作为快速模型
gemini-3.7-flashFlash
gemini-3.6-flashFlash

能否使用取决于 API 密钥的分组,价格和最新列表见 模型广场。

在 Gemini CLI 中配置

在控制台对密钥点击「在 CC Switch 中打开」,工具选择 Gemini,主模型选 gemini-3.1-pro-preview,确认导入。完整步骤见 CC Switch。

首次运行 gemini 时,登录方式选择 Use Gemini API Key。

在 Claude Code 中使用

把 Claude Code 的模型换成 Gemini 模型名即可:

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://omini.ominiapi.top",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_MODEL": "gemini-3.1-pro-preview",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.1-pro-preview",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.1-pro-preview",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.8-flash"
  }
}

在 Codex 中使用

~/.codex/config.toml
model_provider = "omini"
model = "gemini-3.1-pro-preview"

[model_providers.omini]
name = "OminiApi"
base_url = "https://omini.ominiapi.top/v1"
wire_api = "responses"
requires_openai_auth = true

Codex 和 Claude Code 原生面向 GPT / Claude 模型,接入 Gemini 后可能出现模型元数据缺失等提示,部分能力可能受影响。请以实际对话结果为准。

用 API 调用

curl "https://omini.ominiapi.top/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "你好" }] }]
  }'

接口说明见 Gemini。

在 Cherry Studio 中使用

添加提供商时类型选 Gemini,API 地址填 https://omini.ominiapi.top,即可用原生格式调用;类型选 OpenAI 也能用。见 Cherry Studio。

常见问题

Gemini CLI 跳转到 Google 账号登录

在 Gemini CLI 里输入 /auth,改选 Use Gemini API Key。

返回 unsupported Gemini CLI action

「Login with Google」(Code Assist)模式有部分接口平台不支持,请改用 API Key 登录方式。

提示模型不存在

GEMINI_MODEL 要和模型广场里的名字完全一致,例如 gemini-3.1-pro-preview 不能省略 -preview。

本页目录