共通プロトコル概要

OpenRely APIゲートウェイはOpenAI、Anthropic Claude、Google Geminiの主要3大プロトコルをネイティブサポートし、あらゆるAIクライアントと開発ワークフローをサポートします。

概要

開発者がコードを大幅に変更することなく世界のトップAIモデルをシームレスに利用できるよう、OpenRely APIゲートウェイは現代のAIエコシステムにおける主要3大プロトコル仕様に互換対応しています：

OpenAI 互換プロトコル（/v1/chat/completions および /v1/responses 対応）
Anthropic Claude 互換プロトコル（/v1/messages 対応）
Google Gemini 互換プロトコル（/v1beta/models/...:generateContent 対応）

OpenAI Base URLのみを設定可能なツールでも、AnthropicやGeminiのネイティブSDKを前提としたシステムでも、そのまま連携できます。

📌 3大プロトコル選択マトリクス

ご利用のクライアントやSDKに合わせて、対応するプロトコルガイドを選択してください：

OpenAI 互換プロトコル

最も汎用的な業界標準。複数モデルのルーティングとResponses APIをサポート

Claude 互換プロトコル

AnthropicネイティブのMessagesフォーマットと認証仕様

Gemini 互換プロトコル

Google GeminiネイティブのREST APIおよびGenAI SDK連携

⚡ コアプロトコル仕様とクイックテスト

迅速な疎通確認のため、主要3大プロトコルの接続仕様と検証コマンドを以下に示します。標準コマンドは cURL ですが、タブを切り替えて Python や Node.js のコードも確認できます：

推奨選定基準：

クライアントに 「OpenAI / カスタムプロバイダー」 設定がある場合は、OpenAI 互換プロトコル を最優先で推奨します。同一設定でGPT、Claude、Geminiなどの全モデルを呼び出せます。
特定ベンダー専用ツール（Claude専用プラグイン、Google Gemini専用基盤など）の場合のみ、対応するネイティブプロトコルをご利用ください。

1. OpenAI 互換プロトコル（推奨）

Base URL: https://api.openrely.ai/v1
認証ヘッダー: Authorization: Bearer sk-••••
主要エンドポイント: POST /v1/chat/completions ｜ 📖 OpenAI 詳細ガイド ➔

curl -X POST "https://api.openrely.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt",
    "messages": [
      { "role": "user", "content": "Hello OpenRely!" }
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.openrely.ai/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="gpt",
    messages=[{"role": "user", "content": "Hello OpenRely!"}],
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.openrely.ai/v1',
  apiKey: 'sk-your-api-key',
});

const response = await client.chat.completions.create({
  model: 'gpt',
  messages: [{ role: 'user', content: 'Hello OpenRely!' }],
});

console.log(response.choices[0].message.content);

2. Anthropic Claude 互換プロトコル

Base URL: https://api.openrely.ai
認証ヘッダー: x-api-key: sk-••••, anthropic-version: 2023-06-01
主要エンドポイント: POST /v1/messages ｜ 📖 Claude 詳細ガイド ➔

curl -X POST "https://api.openrely.ai/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello Claude!" }
    ]
  }'

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.openrely.ai",
    api_key="sk-your-api-key",
)

response = client.messages.create(
    model="claude",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello Claude!"}],
)

print(response.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

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

const response = await client.messages.create({
  model: 'claude',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello Claude!' }],
});

console.log(response.content[0].text);

3. Google Gemini 互換プロトコル

Base URL: https://api.openrely.ai
認証ヘッダー: x-goog-api-key: sk-•••• (または URLクエリ ?key=sk-...)
主要エンドポイント: POST /v1beta/models/{model}:generateContent ｜ 📖 Gemini 詳細ガイド ➔

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

from google import genai
from google.genai import types

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

response = client.models.generate_content(
    model="gemini",
    contents="Hello Gemini!",
)

print(response.text)

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

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

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

console.log(response.text);

トラブルシューティング

エラー / 現象	原因	対処方法
401 Unauthorized	キーの誤りまたはヘッダー不一致	APIキーが正しく貼り付けられているか確認（`sk-...`）。各プロトコルに応じた正しいヘッダーを使用しているか確認。
404 Not Found	Base URLのパス階層不一致	一部のクライアントは自動でサブパスを補完します。`https://api.openrely.ai/v1` で404となる場合は `/v1` を除いた `https://api.openrely.ai` をお試しください。
429 Rate Limit	残高不足または単一キーの制限超過	OpenRelyコンソールでウォレット残高と該当APIキーの制限設定をご確認ください。

🛠️ 主要モデル機能とエンドポイント一覧

OpenRely は世界中の主要大モデルのマルチモーダル機能を統合しています。以下は主要なエンドポイントとプロトコルの対応表です：

機能	エンドポイント	メソッド	プロトコル	対応モデル例 / 活用シーン
テキスト・対话	`/v1/chat/completions`	`POST`	OpenAI	全モデル共通（GPT-4o、Claude 3.7、Gemini 2.5、DeepSeekなど）、ストリーミング・Tool Calling対応
次世代 Responses	`/v1/responses`	`POST`	OpenAI	OpenAI ネイティブ Responses API。自律型 Agent ワークフローに最適
Claude ネイティブ	`/v1/messages`	`POST`	Claude	Anthropic 原生メッセージ形式。Thinking 思考深度や Prompt Caching に対応
Gemini ネイティブ	`/v1beta/models/{model}:generateContent`	`POST`	Gemini	Google GenAI 原生形式。マルチターン対話や動画マルチモーダル推論に対応
ベクトル埋め込み	`/v1/embeddings`	`POST`	OpenAI	`text-embedding-3-small` / `large` による RAG ベクトル検索
画像生成	`/v1/images/generations`	`POST`	OpenAI	DALL-E 3、Midjourney、FLUX 画像生成
音声認識・文字起こし	`/v1/audio/transcriptions`	`POST`	OpenAI	Whisper 音声認識
音声合成 (TTS)	`/v1/audio/speech`	`POST`	OpenAI	テキストから自然な音声ストリームへの合成
モデル一覧取得	`/v1/models`	`GET`	OpenAI	アカウントが利用可能な全モデル ID の一覧取得

ヒント: 各モデルのリアルタイム料金・倍率は 🏆 モデル広場・料金一覧でご確認いただけます。

共通プロトコル概要

目次