Gemini (SDK / 协议)

配置步骤

1. 我们提供原生 Gemini 兼容端点：路径 /v1beta/models/{model}:generateContent，鉴权用 x-goog-api-key 请求头，或在 URL 上加 ?key=，值为你的 sk-...。
2. 使用 Google GenAI SDK（Python）时，只需把 base URL 指向我们：

from google import genai
from google.genai import types

client = genai.Client(
    api_key="sk-YOUR_KEY",
    http_options=types.HttpOptions(base_url="https://top-api.cc"),
)
resp = client.models.generate_content(
    model="gemini-3.1-pro",
    contents="Hello",
)
print(resp.text)

3. 或用 curl 验证：

curl "https://top-api.cc/v1beta/models/gemini-3.1-pro:generateContent" \
  -H "x-goog-api-key: sk-YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

注意

• SDK 的 base URL 不带 /v1beta（SDK 会自动拼上 /v1beta/models/...）；只有手动 curl 时才写出完整路径。
• 在 Gemini 端点上请使用 Gemini 模型名（如 gemini-3.1-pro），由我们的顶级引擎驱动；当前 Gemini 协议为纯文本对话（图片 / 工具调用暂未映射）。
• 排障：HTTP 200 但回复为空通常是 key 无效或额度问题——请先在 控制台 检查你的 key。
• ⚠️ Google 官方 gemini CLI 目前没有切换后端的开关。若要用编程 CLI，请选 Claude Code 或 Codex；本页面面向 Gemini SDK 及允许自定义 Gemini base URL 的应用。