跳到正文

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://portdan.com"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.0-flash"

发送 HTTP 请求

手写 HTTP 请求时,用 https://portdan.com/v1beta 拼接 endpoint 标签中的路径。

GET /v1beta/models

bash
curl https://portdan.com/v1beta/models \
  -H "x-goog-api-key: sk-your-api-key"

POST /v1beta/models/{model}:generateContent

bash
curl https://portdan.com/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://portdan.com,别填 /v1beta
OpenCode Gemini 404确认 OpenCode Gemini provider 的 Base URL 是 https://portdan.com/v1beta
401检查请求地址、Key 和请求头;按 API 请求错误 处理。
403按过期、余额、订阅、分组和 IP 限制处理,见 API 请求错误

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