Schnellstart

Senden Sie Ihre erste Anfrage.

Erstellen Sie einen Relay-Schlüssel, konfigurieren Sie Ihren Client und wählen Sie ein verfügbares Modell in der Konsole. Diese Beispiele nutzen die Chat-Completions-API.

API-Schlüssel erstellen

1Schlüssel erstellen
2Client konfigurieren
3Modellanfrage senden

Basis-URL

https://proxystacks.com/v1

Modell-ID

YOUR_MODEL_ID

Ersetzen Sie YOUR_MODEL_ID durch eine in Ihrer Konsole verfügbare Modell-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!"}],
)

Authentifizierung

Jede Modellanfrage muss ein Bearer-Token im Authorization-Header mitführen. Relay speichert nur den SHA-256-Hash Ihres API-Schlüssels.

Streaming

Setzen Sie stream: true, um einen standardmäßigen SSE-Datenstrom zu erhalten. Der Guthabenabzug wird nach Ende des Streams automatisch abgeschlossen.

Antwortformat

Nicht gestreamte Antworten nutzen das standardmäßige JSON-Format, ergänzt um eine Relay-Anfrage-ID im Antwort-Header für die einfache Suche in den Logs.

KI-Programmierwerkzeuge

Richten Sie Ihre KI-Programmierwerkzeuge auf das Relay-Gateway. Kopieren Sie einen Konfigurationsblock in die Zieldatei und ersetzen Sie sk-relay-your-key und YOUR_MODEL_ID.

In den env-Block von ~/.claude/settings.json einfügen und Claude Code neu starten. ANTHROPIC_AUTH_TOKEN wird als Bearer-Token gesendet.

~/.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"
  }
}

In ~/.codex/config.toml speichern und den Schlüssel in der Shell setzen: export RELAY_API_KEY=sk-relay-your-key. Codex nutzt die Responses API; Relay leitet zustandslos weiter, daher disable_response_storage beibehalten.

~/.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"

In ~/.config/opencode/opencode.json speichern (oder opencode.json im Projektstamm) und das Modell relay/YOUR_MODEL_ID wählen.

~/.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"
}

Probleme? [email protected]