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" }] }
    ]
  }'