Démarrage rapide

Envoyez votre première requête.

Créez une clé Relay, configurez votre client et choisissez un modèle disponible dans la console. Ces exemples utilisent l'API Chat Completions.

Créer une clé d'API

1Créer une clé
2Configurer votre client
3Envoyer une requête à un modèle

URL de base

https://proxystacks.com/v1

ID de modèle

YOUR_MODEL_ID

Remplacez YOUR_MODEL_ID par un ID de modèle disponible dans votre console.

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!"}],
)

Authentification

Chaque requête de modèle doit porter un jeton Bearer dans l'en-tête Authorization. Relay ne stocke que le hachage SHA-256 de votre clé d'API.

Streaming

Définissez stream: true pour obtenir un flux SSE standard. La déduction du solde se termine automatiquement à la fin du flux.

Format de réponse

Les réponses non streamées utilisent le format JSON standard, accompagné d'un ID de requête Relay dans l'en-tête de réponse pour retrouver facilement le journal.

Outils de code IA

Dirigez vos outils de code IA vers la passerelle Relay. Copiez un bloc de configuration dans le fichier cible, puis remplacez sk-relay-your-key et YOUR_MODEL_ID.

Fusionnez dans le bloc env de ~/.claude/settings.json, puis redémarrez Claude Code. ANTHROPIC_AUTH_TOKEN est envoyé comme jeton 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"
  }
}

Enregistrez dans ~/.codex/config.toml, puis définissez la clé dans votre shell : export RELAY_API_KEY=sk-relay-your-key. Codex utilise l'API Responses ; Relay relaie sans état, conservez donc 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"

Enregistrez dans ~/.config/opencode/opencode.json (ou un opencode.json à la racine du projet), puis choisissez le modèle 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"
}

Un problème ? [email protected]