接入教程 · Gemini

国内调用 Gemini API:一个 base_url 就够

不需要外网环境。创建 Gemini 分组的密钥后,用 OpenAI 兼容端点即可调用 gemini-3.8-flash、gemini-4-carbon 等模型,Python、Node、Cursor、Cherry Studio 都通用。

先确认模型在哪个分组。 Gemini 有「Gemini 全能」和「Gemini-vertex」两个分组,价格不同。 密钥只对所在分组里的模型生效。

可用模型

  • gemini-3.8-flash — 通用主力,响应快
  • gemini-3-flash — 更便宜,适合批量任务
  • gemini-4-carbon / gemini-4-argon / gemini-4-hydrogen — 新一代,按需选择
  • gemini-3-pro-image-preview — 生图

完整清单与实时价格以 价格页 为准(公开接口 /api/pricing)。

Python(OpenAI SDK)

Pythonpy
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.hardysapi.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

Node.js

Node.jsjs
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://api.hardysapi.com/v1",
});

const res = await client.chat.completions.create({
  model: "gemini-3.8-flash",
  messages: [{ role: "user", content: "hi" }],
});
console.log(res.choices[0].message.content);

cURL

cURLbash
curl https://api.hardysapi.com/v1/chat/completions \
  -H "authorization: Bearer sk-你的密钥" \
  -H "content-type: application/json" \
  -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"hi"}]}'

桌面客户端

Cursor、Cherry Studio、Chatbox、Open WebUI 等凡支持「OpenAI 兼容」的客户端,按下面填即可:

  • Base URL:https://api.hardysapi.com/v1
  • API Key:sk- 开头的密钥
  • 模型名:手动填写 gemini-3.8-flash(部分客户端不会自动拉取列表)

常见报错

  • 401 INVALID_API_KEY — 密钥错误或不属于 Gemini 分组。
  • 404 model not found — 模型名不在该分组,或拼写带了错误后缀。
  • 402 / 403 insufficient balance — 余额不足,充值即可。
  • 429 — 并发或频率超限,降并发后重试。

更多错误码见 报错排查指南。

⚠️ 目前请使用 OpenAI 兼容端点调用;Google 官方 SDK 的 /v1beta 原生协议暂未开放。