如果你已经使用 Gemini 风格的 REST 请求，只需要把请求地址、模型路径和 API Key 换成 LinkHarbor 的配置。先跑通一个 generateContent 请求，再按需查看流式、缓存内容和进阶接口。
不建议通过 Google 官方 Gemini SDK 的 base_url 切换到第三方网关。对于 LinkHarbor，请优先直接调用 Gemini 兼容 REST 端点。
跑通第一条请求只需要准备三件事。
在 LinkHarbor 控制台创建或复制一个 API Key。
选择一个 LinkHarbor 平台模型 ID，例如 google/gemini-2.5-flash。
模型 ID 放进 URL path 时，需要把 / 编码成 %2F。
使用 LinkHarbor API 地址，加上 Gemini 风格的模型动作路径。URL 中的 model 段填写 LinkHarbor 平台模型 ID。
https://api.linkharbor.ai/v1beta/models/{model}:generateContent发送非流式 Gemini 风格内容生成请求。
google/gemini-2.5-flash请求时使用平台模型 ID。放入 URL path 前需要先编码斜杠。
Gemini 兼容调用推荐使用 x-goog-api-key，并指定 JSON 请求体。
x-goog-api-key: YOUR_API_KEY
Content-Type: application/jsonAuthorization: Bearer YOUR_API_KEY 和 ?key=YOUR_API_KEY 作为兼容方式可用，但本文推荐使用 x-goog-api-key。
复制下面的请求，把 YOUR_API_KEY 换成你的密钥，然后在终端执行。成功后会返回 candidates 和 usageMetadata。
export LINKHARBOR_API_KEY="YOUR_API_KEY"
curl -sS "https://api.linkharbor.ai/v1beta/models/google%2Fgemini-2.5-flash:generateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $LINKHARBOR_API_KEY" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "请只回复 OK" }
]
}
]
}'第一条请求只需要 contents。等应用需要更多控制时，再添加 generationConfig、tools 等字段。
contentsarray必填。发送给模型的对话内容。
partsarray每条消息里的文本、图片、音频或其他 Gemini 风格内容块。
generationConfigobject可选。控制 temperature、maxOutputTokens、topP、stopSequences 等生成参数。
tools / toolConfigobject可选。配置函数调用工具以及工具调用行为。
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "请只回复 OK" }
]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 1024
}
}大多数应用只需要读取第一条候选回复，并使用 usageMetadata 记录 token 用量。
candidates[0].content.parts[0].textstring第一条候选回复里的模型文本输出。
usageMetadataobject本次请求的 token 用量，包括输入、输出和总 token 数。
finishReasonstring模型停止生成的原因，例如 STOP 或安全相关原因。
request_idstring错误响应中用于支持和排查的请求 ID。
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{ "text": "OK" }
]
},
"finishReason": "STOP",
"index": 0
}
],
"usageMetadata": {
"promptTokenCount": 7,
"candidatesTokenCount": 1,
"totalTokenCount": 8
}
}同一个请求分别展示为 cURL、JavaScript fetch 和 Python requests。
curl -sS "https://api.linkharbor.ai/v1beta/models/google%2Fgemini-2.5-flash:generateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $LINKHARBOR_API_KEY" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "请只回复 OK" }
]
}
]
}'这些习惯能让 Gemini 兼容迁移更容易排查，也更安全。
它符合 Gemini API 约定，也能避免和 OpenAI 兼容 Bearer 请求混淆。
将平台模型 ID 放入 URL path 前，请把 / 编码成 %2F。
当前网关下，直接 REST 调用比尝试改写官方 Gemini SDK base URL 更可控。
Gemini 兼容接入中常见问题的快速解答。
查看可用于 Gemini 兼容路径的平台模型 ID。
查看模型使用 OpenAI 兼容 SDK 和 Chat Completions 客户端。
查看配置为 Claude 风格 SDK 和 Agent 工具配置 LinkHarbor。
查看配置