クイックスタート

最初のリクエストを送信する。

Relay キーを作成し、クライアントを設定し、コンソールから利用可能なモデルを選択します。以下の例では Chat Completions API を使用します。

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/settings.json の env ブロックにマージし、Claude Code を再起動します。ANTHROPIC_AUTH_TOKEN は Bearer トークンとして送信されます。

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-relay-your-key",
    "ANTHROPIC_BASE_URL": "https://proxystacks.com/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_MODEL_ID"
  }
}

~/.codex/config.toml に保存し、シェルでキーを設定します: export RELAY_API_KEY=sk-relay-your-key。Codex は Responses API を使用します。Relay はステートレスに転送するため、disable_response_storage は残してください。

~/.codex/config.toml

model = "YOUR_MODEL_ID"
model_provider = "relay"
disable_response_storage = true

[model_providers.relay]
name = "Relay"
base_url = "https://proxystacks.com/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"

~/.config/opencode/opencode.json（またはプロジェクト直下の opencode.json）に保存し、モデル relay/YOUR_MODEL_ID を選択します。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "relay": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Relay",
      "options": {
        "baseURL": "https://proxystacks.com/v1",
        "apiKey": "sk-relay-your-key"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  },
  "model": "relay/YOUR_MODEL_ID"
}

お困りですか？ [email protected]