Início rápido

Envie sua primeira requisição.

Crie uma chave do Relay, configure seu cliente e escolha um modelo disponível no console. Estes exemplos usam a API Chat Completions.

Criar chave de API

1Criar uma chave
2Configurar seu cliente
3Enviar uma requisição a um modelo

URL base

https://proxystacks.com/v1

ID do modelo

YOUR_MODEL_ID

Substitua YOUR_MODEL_ID por um ID de modelo disponível no seu 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!"}],
)

Autenticação

Toda requisição a modelo deve levar um token Bearer no cabeçalho Authorization. O Relay armazena apenas o hash SHA-256 da sua chave de API.

Streaming

Defina stream: true para receber um fluxo SSE padrão. A dedução do saldo é concluída automaticamente quando o fluxo termina.

Formato de resposta

Respostas sem streaming usam o formato JSON padrão, além de um ID de requisição do Relay no cabeçalho da resposta para facilitar a busca nos logs.

Ferramentas de código com IA

Aponte suas ferramentas de código com IA para o gateway Relay. Copie um bloco de configuração para o arquivo de destino e substitua sk-relay-your-key e YOUR_MODEL_ID.

Mescle no bloco env de ~/.claude/settings.json e reinicie o Claude Code. O ANTHROPIC_AUTH_TOKEN é enviado como 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"
  }
}

Salve em ~/.codex/config.toml e defina a chave no shell: export RELAY_API_KEY=sk-relay-your-key. O Codex usa a Responses API; o Relay encaminha sem estado, então mantenha 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"

Salve em ~/.config/opencode/opencode.json (ou em um opencode.json na raiz do projeto) e selecione o modelo 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"
}

Com problemas? [email protected]