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 キーを設定するだけで、最先端の Gemini モデルによる高並行呼び出しをシームレスにご利用いただけます。

📌 コア接続仕様

パラメータ項目	標準設定値	説明
API サービスアドレス (Base URL)	`https://api.openrely.ai`	クライアントの要件に応じて、一部のツールでは内部で自動的に `/v1beta` が追加されます。必要な場合は `https://api.openrely.ai/v1beta` を入力してください
認証方式 (Headers / Query)	`x-goog-api-key: sk-••••`	Header で OpenRely キーを渡すことを推奨します。URL クエリパラメータ `?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="Explain quantum mechanics in one sentence",
)

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 クエリパラメータとして付与することができます：

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