平台使用

Gemini 接入

在 hahacode 中调用 Gemini 模型

hahacode 已接入 gemini 分组。创建令牌时选择 gemini 分组后，可以用同一个 API Key 调用 Gemini 模型。

这里填写的是 hahacode 控制台生成的 API Key，不是 Google AI Studio 的 Gemini API Key。

请求格式#

Gemini 有两种常见接入方式。在 hahacode 里，路径不要混用：

场景	Base URL	最终请求路径	说明
Gemini 原生格式	`https://hahacode.com/v1beta`	`POST /v1beta/models/模型名:generateContent`	Gemini CLI / Google(Gemini) SDK 场景使用
OpenAI 兼容格式	`https://hahacode.com/v1`	`POST /v1/chat/completions`	在 Codex、OpenCode、OpenClaw、Cherry Studio 等 OpenAI 兼容工具里使用

如果 API 请求需要加速，把对应 Base URL 改为 https://cn.hahacode.com/v1beta 或 https://cn.hahacode.com/v1。

CC Switch 配置#

如果是在 Codex / OpenCode / OpenClaw 等工具里使用 Gemini，优先在 hahacode 控制台「API 密钥管理」点击「导入到 CCS」。 Gemini CLI 原生格式再按下面的 /v1beta 地址单独确认。

推荐优先用 CC Switch 管理工具配置。不同标签页对应不同请求格式：

配置 Gemini CLI：选择 Gemini 标签，接口格式选 Google (Gemini)，Base URL 填 https://hahacode.com/v1beta。
配置 Codex / OpenCode / OpenClaw：选择对应工具标签，按 OpenAI 兼容格式填写请求地址。
模型名填写可用模型，例如 gemini-3.5-flash-high。

Gemini 原生格式的 Base URL 需要带 /v1beta。工具会在后面拼接 /models/模型名:generateContent。

可用模型#

模型
`gemini-3-flash`
`gemini-3-pro-high`
`gemini-3-pro-low`
`gemini-3.1-flash-image`
`gemini-3.1-flash-lite`
`gemini-3.1-pro-high`
`gemini-3.1-pro-low`
`gemini-3.5-flash-high`
`gemini-3.5-flash-low`
`gemini-3.5-flash-medium`

调用示例#

Gemini 原生格式：

bash

curl https://hahacode.com/v1beta/models/gemini-3.5-flash-low:generateContent \
  -H "x-goog-api-key: sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "你好，介绍一下你自己" }
        ]
      }
    ]
  }'

OpenAI 兼容格式：

bash

curl https://hahacode.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash-low",
    "messages": [
      { "role": "user", "content": "你好，介绍一下你自己" }
    ]
  }'

官方参考： Gemini 原生 generateContent、 Gemini OpenAI 兼容接口。