Inicio rápido

Envía tu primera solicitud.

Crea una clave de Relay, configura tu cliente y elige un modelo disponible en la consola. Estos ejemplos usan la API Chat Completions.

Crear clave de API

1Crea una clave
2Configura tu cliente
3Envía una solicitud a un modelo

URL base

https://proxystacks.com/v1

ID de modelo

YOUR_MODEL_ID

Sustituye YOUR_MODEL_ID por un ID de modelo disponible en tu consola.

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

Autenticación

Toda solicitud a un modelo debe incluir un token Bearer en la cabecera Authorization. Relay solo almacena el hash SHA-256 de tu clave de API.

Streaming

Define stream: true para recibir un flujo SSE estándar. El descuento del saldo se completa automáticamente cuando termina el flujo.

Formato de respuesta

Las respuestas sin streaming usan el formato JSON estándar, además de un ID de solicitud de Relay en la cabecera de respuesta para localizar el registro en los logs.

Herramientas de código con IA

Apunta tus herramientas de código con IA a la pasarela Relay. Copia un bloque de configuración en el archivo correspondiente y sustituye sk-relay-your-key y YOUR_MODEL_ID.

Combínalo con el bloque env de ~/.claude/settings.json y reinicia Claude Code. ANTHROPIC_AUTH_TOKEN se envía 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"
  }
}

Guárdalo en ~/.codex/config.toml y define la clave en tu shell: export RELAY_API_KEY=sk-relay-your-key. Codex usa la Responses API; Relay reenvía sin estado, así que mantén 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"

Guárdalo en ~/.config/opencode/opencode.json (o en un opencode.json en la raíz del proyecto) y elige el 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"
}

¿Problemas? [email protected]