跳到正文

Gemini v1beta

Gemini 有两种填法:Gemini CLI 填根地址;手写 HTTP 和 OpenCode Gemini provider 填 /v1beta 地址。

配置 Gemini CLI

在终端或 PowerShell 中执行。模型先从当前分组复制,下面的固定模型名仅作兜底示例;把 sk-your-api-key 换成完整 Key。

bash
export GOOGLE_GEMINI_BASE_URL="https://api.zhiwei.dpdns.org"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.0-flash"

发送 HTTP 请求

手写 HTTP 请求时,用 https://api.zhiwei.dpdns.org/v1beta 拼接 endpoint 标签中的路径。

GET /v1beta/models

bash
curl https://api.zhiwei.dpdns.org/v1beta/models \
  -H "x-goog-api-key: sk-your-api-key"

POST /v1beta/models/{model}:generateContent

bash
curl https://api.zhiwei.dpdns.org/v1beta/models/gemini-2.0-flash:generateContent \
  -H "x-goog-api-key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "请只回复 OK"}]
      }
    ]
  }'

处理填错

错误处理
Gemini CLI 404CLI 应填 https://api.zhiwei.dpdns.org,别填 /v1beta
OpenCode Gemini 404确认 OpenCode Gemini provider 的 Base URL 是 https://api.zhiwei.dpdns.org/v1beta
401检查请求地址、Key 和请求头;按 常见报错解释 处理。
403检查分组、模型和余额;按 常见报错解释 处理。

智维 API 接入、配置与排查指南。