Gemini v1beta

GET /v1beta/models

Gemini 原生接口用于 Gemini CLI、Google GenAI SDK、OpenCode Gemini provider 等场景。

Base URL

场景	填写值
Gemini CLI	https://portdan.com
直接 HTTP 请求	https://portdan.com/v1beta
OpenCode Gemini provider	https://portdan.com/v1beta

Gemini CLI 使用根地址，由 CLI 拼 /v1beta。直接请求 API 或 OpenCode provider 的 baseURL 则填 /v1beta。

Gemini CLI 环境变量

macOS / Linux：

export GOOGLE_GEMINI_BASE_URL="https://portdan.com"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.0-flash"

Windows CMD：

set GOOGLE_GEMINI_BASE_URL=https://portdan.com
set GEMINI_API_KEY=sk-your-api-key
set GEMINI_MODEL=gemini-2.0-flash

PowerShell：

$env:GOOGLE_GEMINI_BASE_URL="https://portdan.com"
$env:GEMINI_API_KEY="sk-your-api-key"
$env:GEMINI_MODEL="gemini-2.0-flash"

WARNING

GEMINI_API_KEY 仍然填 Portdan 控制台原始 Key，不要改成 Google AI Studio 的 AIza...，也不要加 #gemini 后缀。

请求头

推荐：

x-goog-api-key: sk-your-api-key

也兼容：

Authorization: Bearer sk-your-api-key
x-api-key: sk-your-api-key

?key=<API_KEY> 在 /v1beta 兼容，但不推荐。?api_key=<API_KEY> 会被拒绝。

列出模型

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

generateContent 示例

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"}
        ]
      }
    ]
  }'

OpenCode Gemini provider 示例

{
  "provider": {
    "gemini": {
      "npm": "@ai-sdk/google",
      "options": {
        "baseURL": "https://portdan.com/v1beta",
        "apiKey": "sk-your-api-key"
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

常见错误

现象	原因
401	Key 原文不匹配、加了后缀、Key 过期或删除
400 query api_key deprecated	使用了 ?api_key=，应换请求头或 ?key=
404	把 Gemini CLI 根地址误填成 /v1beta 后又被 CLI 二次拼接，或路径拼错
model not found	当前 Gemini 分组未开放该模型