GlobalAiOpc

Gemini Native API

基于 Gemini 原生协议的对话接口，适合直接使用 generateContent 或 streamGenerateContent 协议接入

POST/gw_llm_power/v1/models/{model}:generateContent

baseUrlhttp://apillm.globalaiopc.com/gw_llm_power

兼容 Gemini 官方文档，可直接参考以下文档进行接入：

Gemini generateContent：https://ai.google.dev/api/generate-content

认证

获取 Key

使用 Authorization 请求头进行身份认证。

cURL

Authorization: Bearer {{YOUR_API_KEY}}
Content-Type: application/json

说明：

Authorization：API 密钥，格式为 Bearer {{YOUR_API_KEY}}

支持的模型

当前支持以下模型，已按模型家族与版本类型整理：

Gemini

标准 / 稳定版	official版	低价版
`gemini-2.5-flash-lite`	-	-
`gemini-2.5-pro`	`gemini-2.5-pro-official`	`gemini-2.5-pro-low`
`gemini-3-flash-preview`	`gemini-3-flash-preview-official`	`gemini-3-flash-preview-low`
`gemini-3.1-flash-lite-preview`	-	-
`gemini-3.1-pro-preview`	`gemini-3.1-pro-preview-official`	`gemini-3.1-pro-preview-low`

版本说明

后缀 / 类型	说明
无后缀	标准版 / 稳定版
`-official`	official版
`-low`	低价版本

多模态能力支持

图片分析

全部支持，无需区分。

视频分析

全部支持，无需区分。

请求地址

支持以下 Gemini 原生路径：

POST /v1/models/{model}:generateContent
POST /v1/models/{model}:streamGenerateContent

完整地址示例：

Text

http://apillm.globalaiopc.com/gw_llm_power/v1/models/gemini-3.1-pro-preview:generateContent

请求参数

contentsarray必填

Gemini 原生消息内容数组。每个元素通常包含 role 和 parts

contents[].rolestring

消息角色，常见值为 user 或 model

contents[].partsarray必填

消息片段数组。常见为 text 对象，也支持 Gemini 原生多模态结构

contents[].parts[].textstring

文本内容

generationConfig.temperaturenumber

采样温度

generationConfig.topPnumber

核采样参数

generationConfig.maxOutputTokensinteger

最大输出 token 数

systemInstruction.parts[].textstring

系统提示词，可选

响应说明

接口返回 Gemini 原生风格响应。

candidates[].content.parts[].textstring

模型生成的文本内容

candidates[].finishReasonstring

生成结束原因

usageMetadata.promptTokenCountinteger

输入 token 数

usageMetadata.candidatesTokenCountinteger

输出 token 数

usageMetadata.totalTokenCountinteger

总 token 数

注意事项

路径中的 {model} 需要替换为实际模型名，例如 gemini-3.1-pro-preview
流式场景请使用 :streamGenerateContent
请使用 Authorization 请求头传递 API 密钥