Gemini原生接口
Gemini 原生接口
概述
接入信息
| 项目 | 值 |
|---|---|
| Base URL | https://api.nexara.net |
| 认证头 | Authorization: Bearer sk-nex-your-key-here |
| 非流式端点 | POST /v1beta/models/{model}:generateContent |
| 流式端点 | POST /v1beta/models/{model}:streamGenerateContent?alt=sse |
注意： 使用 AIone 的 API Key（ sk-nex-xxx），不是 Google 的 API Key。
支持的模型
gemini-2.5-flash、gemini-2.5-pro、gemini-3-pro-preview、gemini-3-flash-preview、gemini-3.1-pro 等gemini-3.1-flash-image-preview、gemini-3-pro-image-preview、gemini-2.5-flash-image 等GET https://api.nexara.net/v1/models。非流式请求 — generateContent
基础示例
响应格式
{
"candidates": [
{
"content": {
"parts": [{"text": "量子计算是利用量子力学原理..."}],
"role": "model"
},
"finishReason": "STOP",
"index": 0
}
],
"usageMetadata": {
"promptTokenCount": 10,
"candidatesTokenCount": 25,
"totalTokenCount": 35
},
"modelVersion": "gemini-2.5-flash"
}图片生成示例
candidates[0].content.parts[] 中以 inlineData 形式返回（base64 编码）。注意： 4K 图片生成可能需要 2-3 分钟，请将客户端 HTTP 超时设置为 ≥ 600 秒。
流式请求 — streamGenerateContent
?alt=sse，响应以 SSE (Server-Sent Events) 格式逐 chunk 返回。示例
SSE 响应格式
data: {"candidates":[{"content":{"parts":[{"text":"春风"}],"role":"model"},"index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":2,"totalTokenCount":10}}
data: {"candidates":[{"content":{"parts":[{"text":"拂面来，"}],"role":"model"},"index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":5,"totalTokenCount":13}}
data: {"candidates":[{"content":{"role":"model"},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":28,"totalTokenCount":36}}data: 行是一个独立的 JSON 对象。usageMetadata 是累积值，最后一个 chunk 的数值为最终用量。注意： 图片生成模型不支持 streamGenerateContent，请使用generateContent。
Python SDK 示例
Node.js SDK 示例
注意： Google 官方 SDK 可能不直接支持自定义 endpoint。如果遇到此限制，建议使用 HTTP 直接调用或使用支持自定义 Base URL 的第三方库。
与 OpenAI 兼容格式的对比
| 维度 | Gemini 原生格式 | OpenAI 兼容 格式 |
|---|---|---|
| 端点 | /v1beta/models/{model}:generateContent | /v1/chat/completions |
| 请求体 | contents + generationConfig | messages + max_tokens |
| 响应体 | candidates + usageMetadata | choices + usage |
| 图片参数 | imageConfig.imageSize / imageConfig.aspectRatio | image_size / aspect_ratio |
| 流式 | :streamGenerateContent?alt=sse | "stream": true |
| 适用场景 | 自建网关聚合、已有 Gemini 代码 | 通用客户端、IDE 插件 |
限制与注意事项
1.
sk-nex- API Key，不是 Google API Key2.
streamGenerateContent 对图片生成模型伆返回 503，请使用 generateContent3.
generateContent 和 streamGenerateContent，不支持 countTokens、embedContent 等4.
5.
修改于 2026-04-10 07:35:08