Gemini 兼容协议

了解如何通过 Google Gemini 原生协议（/v1beta/models/...:generateContent）将 Google GenAI SDK、AI Studio 客户端及第三方应用接入 OpenRely。

协议概述

部分基于 Google 技术栈打造的桌面应用、数据分析工具、Chrome 扩展以及使用官方 Google GenAI SDK（如 google-genai 或 @google/genai）的开发项目，直接与 Google Gemini 原生 REST 接口规范 通信。

OpenRely API 原生支持 Gemini /v1beta/models/{model}:generateContent 端点，兼容原生参数与多模态 Parts 结构。您无需更改代码逻辑，仅需配置 Base URL 与 API Key 即可畅享顶尖 Gemini 模型的高并发调用。

📌 核心连接规范

参数项	标准填写值	说明
API 服务地址 (Base URL)	`https://api.openrely.ai`	根据客户端要求，部分工具底层会自动追加 `/v1beta`，若需要可填 `https://api.openrely.ai/v1beta`
鉴权方式 (Headers / Query)	`x-goog-api-key: sk-••••`	推荐使用 Header 传入 OpenRely Key；亦兼容 URL Query 参数 `?key=sk-••••`
数据格式	`Content-Type: application/json`	标准 JSON 请求与响应体

⚡ 核心端点与请求示例

内容生成 (generateContent)

Google Gemini 原生核心生成端点，支持文本生成、多模态图文输入、结构化 JSON 输出与上下文多轮对话。

端点：POST /v1beta/models/{model}:generateContent
完整 URL：https://api.openrely.ai/v1beta/models/gemini:generateContent

请求示例 (Request)

curl -X POST "https://api.openrely.ai/v1beta/models/gemini:generateContent" \
  -H "x-goog-api-key: sk-••••" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "Hello Gemini!" }]
      }
    ]
  }'

响应示例 (Response)

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Gemini request served."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 15,
    "totalTokenCount": 25
  }
}

🛠️ 客户端与 SDK 快速集成

Google 官方推出的最新版 google-genai SDK 支持直接覆盖 API 端点：

from google import genai
from google.genai import types

client = genai.Client(
    api_key="sk-your-openrely-key",
    http_options=types.HttpOptions(
        base_url="https://api.openrely.ai",
    ),
)

response = client.models.generate_content(
    model="gemini",
    contents="用一句话解释什么是量子力学",
)

print(response.text)

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({
  apiKey: 'sk-your-openrely-key',
  endpoint: 'https://api.openrely.ai',
});

const response = await ai.models.generateContent({
  model: 'gemini',
  contents: 'Hello Gemini!',
});

console.log(response.text);

若部分遗留第三方工具不支持自定义 HTTP 请求头，可以直接将密钥作为 URL Query 参数携带：

curl -X POST "https://api.openrely.ai/v1beta/models/gemini:generateContent?key=sk-your-openrely-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      { "role": "user", "parts": [{ "text": "Ping" }] }
    ]
  }'