GEM 3.1 Pro API 接入文档
模型 ID gem-3.1-pro · 大厂直供 · 走 Gemini generateContent,可用率 99.8%,3 条线路自动切换。
迄今为止最智能的模型系列,以先进的推理能力为基础,最适合需要广泛世界知识和跨模态的高级推理的复杂任务。
协议与端点endpoint
https://api.lk888.ai/v1beta/models/gem-3.1-pro:generateContenthttps://api.lk888.ai/v1beta/models/gem-3.1-pro:streamGenerateContent流式请求走 streamGenerateContent;非流式走 generateContent。
推荐 SDK:google-genai(Python) / @google/generative-ai(Node)。Gemini 兼容 接口,把 SDK 的 base_url 换成 https://api.lk888.ai、model 换成 gem-3.1-pro,其余保持不变。
鉴权auth
x-goog-api-key: sk-xxxxxxxx本站同时兼容 Authorization: Bearer、x-api-key、x-goog-api-key、?key= 四种方式,按你的 SDK 习惯填即可;同时带多个头时以 Bearer 为准。
密钥可在控制台设置 IP 白名单(单个 IP 或 CIDR 网段)。名单外的来源调用会返回 403、error.code = ip_not_allowed,报错里带平台看到的来源 IP,不扣费;把该 IP 加进白名单或清空白名单即可。
请求示例example
下面是最小可用请求,直接 POST 到上面的端点即可。要流式,把 stream 置为 true。
curl -X POST 'https://api.lk888.ai/v1beta/models/gem-3.1-pro:generateContent' \
-H 'x-goog-api-key: $LK_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "gem-3.1-pro",
"contents": [
{
"role": "user",
"parts": [
{
"text": "用一句话解释什么是 Base URL。"
}
]
}
]
}'import os, requests
r = requests.post(
"https://api.lk888.ai/v1beta/models/gem-3.1-pro:generateContent",
headers={"x-goog-api-key": os.environ["LK_API_KEY"]},
json={"contents": [{"parts": [{"text": "Hello"}]}]},
timeout=60,
)
r.raise_for_status()
print(r.json()["candidates"][0]["content"]["parts"][0]["text"])const r = await fetch("https://api.lk888.ai/v1beta/models/gem-3.1-pro:generateContent", {
method: "POST",
headers: {
"x-goog-api-key": process.env.LK_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ contents: [{ parts: [{ text: "Hello" }] }] }),
});
const data = await r.json();
console.log(data.candidates[0].content.parts[0].text);{
"model": "gem-3.1-pro",
"contents": [
{
"role": "user",
"parts": [
{
"text": "用一句话解释什么是 Base URL。"
}
]
}
]
}流式输出streaming
请求体里加上 stream: true 即可开启流式返回。
curl -X POST 'https://api.lk888.ai/v1beta/models/gem-3.1-pro:streamGenerateContent?alt=sse' \
-H 'x-goog-api-key: $LK_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "gem-3.1-pro",
"contents": [
{
"role": "user",
"parts": [
{
"text": "用一句话解释什么是 Base URL。"
}
]
}
]
}'返回 SSE 事件流,每个 chunk 是一条 candidates 增量,与 Gemini 协议一致。
查本次花费billing
想知道这一次调用实际花了多少:响应头 X-Task-Id 是本平台任务号,流式与非流式都带。拿它调下面的接口,is_final = true 时的 cost 就是本次实际结算金额。
https://api.lk888.ai/v1/skills/task-status?task_id={task_id}返回里同时带 input_tokens / output_tokens。响应体里的 id 由上游生成,不能用来查询。平台是先把响应交付给你、随后立即结算,收到响应马上查若 is_final 仍是 false,隔 1~2 秒重查即可。
官方 SDK 读响应头:Python 用 .with_raw_response,JS 用 .withResponse()。
第三方工具接入clients
Cursor、Cline / Roo Code、Cherry Studio、LobeChat、NextChat、OpenWebUI、Continue 等支持自定义端点的客户端,都按下面四项填。
| 填什么 | 值 |
|---|---|
| Base URL | https://api.lk888.ai |
| API Key | sk- 开头,在控制台创建(可设 IP 白名单) |
| 模型 ID | gem-3.1-pro |
| 协议 | Gemini generateContent |
填完保存后发一条测试消息即可验证;若报 401 检查 Key,报 403 检查 IP 白名单。
常见错误errors
| 状态码 | error.code | 怎么处理 |
|---|---|---|
401 | invalid_api_key | Key 不存在或已删除,回控制台重新创建 |
402 | insufficient_balance | 余额不足,主站充值后即时生效(余额与主站共用) |
403 | ip_not_allowed | 来源 IP 不在白名单,报错里带平台看到的 IP,不扣费 |
404 | model_not_found | 模型 ID 写错,或该模型已下线;用本页顶部的 ID 精确复制 |
429 | rate_limited | 并发或频率超限,退避重试;也可换用同系列其它线路 |
5xx | upstream_error | 上游渠道异常,平台会自动切换同模型的其它线路,重试即可 |
一个 Key 可同时用于多台服务器。建议按环境各建一把并配 IP 白名单,便于审计与随时停用;余额与主站共用,每一笔调用都能在控制台按条查到。
批量采购、对公结算、商务合作请走主站联系入口。
联系商务合作 →