⚡ APIとプレイグラウンドの使用

プレイグラウンドでAIモデルをオンライン体験・テストし、OpenAI / Anthropic / Gemini標準互換インターフェースを通じてシームレスに呼び出します。

プレイグラウンド

プレイグラウンド（Playground）は、軽量なオンラインデバッグおよび体験環境を提供し、コードを一切書かずにモデルと直接マルチターン対話を行い、効果を検証できます。

グループとモデルの選択：入力欄の右下でチャネルグループとテスト対象の具体的なモデルを選択します。
生成パラメータの設定：パラメータボタンをクリックし、必要に応じて Temperature、Top P、頻度ペナルティ（Frequency Penalty）、および最大トークン数（Max Tokens）を調整します。
対話プロンプトの入力：下部の入力欄にテストの質問や System Prompt を入力します。
送信とデバッグ：「送信」をクリックしてリクエストを送信し、ストリーミング応答、トークン消費量、レスポンス所要時間をリアルタイムで確認します。

APIエンドポイントと認証

プラットフォームの標準互換 Base URL は以下の通りです：

https://api.openrely.ai/v1

HTTP リクエストヘッダーに API キーを Bearer Token として渡します：

Authorization: Bearer sk-your-api-key

チャット補完（Chat Completions）を例にします：

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

SDKコード例

Python（OpenAI SDK）

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

ClaudeネイティブMessagesプロトコル

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

Geminiネイティブ形式

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

サポートされているエンドポイント一覧

プラットフォームは主要な大規模言語モデルのプロトコル仕様に完全対応しており、主なサポートエンドポイントは以下の通りです：

インターフェース分類	パス	プロトコルおよび機能の説明
チャット補完	`POST /v1/chat/completions`	OpenAI Chat Completions 互換インターフェース。フル機能のストリーミング出力（SSE）、Function Calling、マルチモーダル入力に対応。
プレイグラウンドチャット	`POST /pg/chat/completions`	コンソール Web プレイグラウンド専用インターフェース。統合されたルーティング、プロトコル変換、課金、リトライチェーンを再利用。
Claude Messages	`POST /v1/messages`	Anthropic Claude ネイティブ互換インターフェース。Claude 公式 SDK およびネイティブクライアントからのシームレスな直接接続に対応。
Gemini ネイティブ呼び出し	`POST /v1beta/models/{model}:{action}`	Google Gemini ネイティブ形式インターフェース。`generateContent`、`streamGenerateContent` などの操作に対応。
Gemini 互換呼び出し	`POST /v1/models/{model}:{action}`	`/v1` プレフィックスで Gemini スタイルのモデル操作リクエストを受け付け、プロトコルの解析と変換を自動実行。
ベクトル埋め込み	`POST /v1/embeddings`	テキストを一括でベクトル化し、アップストリームの Embeddings チャネルに自動適応。
リランキング	`POST /v1/rerank`	`query` に基づいて候補の `documents` の関連性をリランキング。RAG 強化検索に適用。
画像生成	`POST /v1/images/generations`	Text-to-Image インターフェース。DALL·E、FLUX、Midjourney などの生成モデルに対応。
画像編集	`POST /v1/images/edits`	画像編集およびインペインティング。JSON および `multipart/form-data` アップロードリクエストに対応。
音声文字起こし	`POST /v1/audio/transcriptions`	Whisper 音声認識。音声をテキストに文字起こし。
テキスト音声変換	`POST /v1/audio/speech`	TTS 音声合成。テキストを高音質なオーディオストリームとしてレンダリング。
モデレーション	`POST /v1/moderations`	不適切コンテンツのフィルタリングおよびコンプライアンス検出。
Responses API	`POST /v1/responses`	OpenAI Responses 形式インターフェース。コンテキスト圧縮および高度なイベント処理に対応。
リアルタイム対話	`GET /v1/realtime` (WebSocket)	OpenAI Realtime スタイルの全二重・リアルタイム・低遅延な音声/テキストストリームインターフェース。
モデル一覧	`GET /v1/models`	現在利用可能なモデル一覧を取得。OpenAI、Anthropic、Gemini のリクエストヘッダーに応じたアダプティブレスポンス形式に対応。
モデル詳細	`GET /v1/models/{model}`	特定モデルの設定および機能の詳細を取得。