クイックスタート
最初のリクエストを送信する。
Relay キーを作成し、クライアントを設定し、コンソールから利用可能なモデルを選択します。以下の例では Chat Completions API を使用します。
- 1キーを作成
- 2クライアントを設定
- 3モデルにリクエストを送信
ベース URL
https://proxystacks.com/v1
モデル ID
YOUR_MODEL_ID
YOUR_MODEL_ID を、コンソールで利用可能なモデル ID に置き換えてください。
curl https://proxystacks.com/v1/chat/completions \
-H "Authorization: Bearer sk-relay-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [
{ "role": "user", "content": "Hello, Relay!" }
],
"stream": true
}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.RELAY_API_KEY,
baseURL: "https://proxystacks.com/v1",
});
const stream = await client.chat.completions.create({
model: "YOUR_MODEL_ID",
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["RELAY_API_KEY"],
base_url="https://proxystacks.com/v1",
)
response = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[{"role": "user", "content": "Hello!"}],
)認証
すべてのモデルリクエストは、Authorization ヘッダーに Bearer トークンを付ける必要があります。Relay は API キーの SHA-256 ハッシュのみを保存します。
ストリーミング
stream: true を設定すると、標準の SSE データストリームを取得できます。ストリーム終了後に残高の差し引きが自動で完了します。
レスポンス形式
非ストリーミングのレスポンスは標準の JSON 形式で返り、レスポンスヘッダーにログ検索用の Relay リクエスト ID が付きます。
AI コーディングツール
お使いの AI コーディングツールを Relay ゲートウェイに向けます。設定ブロックを対象ファイルにコピーし、sk-relay-your-key と YOUR_MODEL_ID を置き換えてください。
Claude Code~/.claude/settings.json~/.claude/settings.json の env ブロックにマージし、Claude Code を再起動します。ANTHROPIC_AUTH_TOKEN は Bearer トークンとして送信されます。Codex~/.codex/config.toml~/.codex/config.toml に保存し、シェルでキーを設定します: export RELAY_API_KEY=sk-relay-your-key。Codex は Responses API を使用します。Relay はステートレスに転送するため、disable_response_storage は残してください。OpenCode~/.config/opencode/opencode.json~/.config/opencode/opencode.json（またはプロジェクト直下の opencode.json）に保存し、モデル relay/YOUR_MODEL_ID を選択します。