原生路径支持
使用 /v1beta/models/{model}:generateContent 组织请求，降低协议转换理解成本。
Gemini API
用 Gemini 原生接口构建多模型应用
通过 v1beta 标准路径与 contents 请求结构接入 Gemini，把认证、密钥和用量管理集中到 MoonGPT 控制台。
Gemini v1beta原生 REST 接口
generateContent标准内容生成
流式可用支持 SSE 交互
Overview
保留 Gemini 原生调用习惯
Gemini 原生 API 使用 contents、parts 等结构组织文本与多模态内容。MoonGPT 提供对应的 v1beta 路由，适合已经围绕 Gemini SDK 或 REST 结构开发的项目。
网关会按照 API Key 所属分组选择对应能力。模型名、输入类型和高级功能可能随上游与平台配置变化，因此应把模型清单视为运行时配置，而不是写死在页面中。
适合这样接入
- 项目使用 Gemini contents / parts 请求结构
- 需要原生 generateContent 或流式入口
- 希望避免在多个平台分别维护密钥
- 需要在服务端统一记录 API 用量
Why MoonGPT
从认证到调用保持一致
标准认证头
通过 x-goog-api-key 发送 MoonGPT Key，避免把凭证写入 URL 查询参数。
流式生成
通过 streamGenerateContent 与 SSE 逐步消费结果，适配交互式应用。
模型清单可查
认证后可结合模型列表与控制台信息确定当前实际可用模型。
密钥集中管理
在同一 控制台创建、停用并追踪 Gemini 分组的 API Key。
应用侧更安全
把密钥保存在服务端环境变量中，前端只访问你自己的业务接口。
curl · Gemini generateContentMoonGPT API
curl "https://api.moongpt.icu/v1beta/models/YOUR_MODEL_NAME:generateContent" \
-H "x-goog-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{
"role": "user",
"parts": [{"text": "给出三个产品命名方向"}]
}]
}'Getting started
三步完成接入
账户操作仍在独立的 控制台完成，SEO 官网不复制登录、充值或 Key 管理功能。
创建 Gemini 分组 Key
进入控制台，确认分组能力后生成独立 API Key。
使用原生 v1beta 地址
将 SDK 或 REST 客户端的根地址改为 MoonGPT 域名。
校验内容与错误
用最小 contents 请求验证，再扩展到流式或多模态场景。
Use cases
常见使用场景
内容理解
对文本进行分类、摘要与信息提取，并对结构化结果进行业务校验。
交互式生成
为问答、写作和研究工具提供流式内容生成体验。
多模态原型
根据当前模型与接口能力验证图片、文本等组合输入场景。
请注意：Gemini 与 Google 是其各自权利人的商标。MoonGPT 与 Google 不存在官方隶属或背书关系；多模态和模型能力以实际分组为准。
FAQ
关于 Gemini API
Gemini 原生 API 地址是什么？
Gemini 原生接口从 https://api.moongpt.icu/v1beta 开始，生成内容使用 /models/{model}:generateContent。
Gemini 接口使用什么认证头？
推荐使用 x-goog-api-key 请求头传递 MoonGPT API Key。网关也兼容部分常见 Bearer 或 x-api-key 认证方式。
可以直接把密钥放在浏览器前端吗？
不建议。任何可交付给用户的前端代码都可能暴露密钥，应由你自己的服务端保存密钥并代理业务请求。
如何获取当前模型名？
请以控制台中的分组信息为准，也可以在完成认证后调用 Gemini 模型列表入口检查当前可用项。
Start building
开始使用 Gemini 原生接口
创建 API Key，用一个最小 contents 请求验证接入。