빠른 시작
첫 요청을 보내세요.
Relay 키를 만들고 클라이언트를 설정한 뒤 콘솔에서 사용 가능한 모델을 선택하세요. 아래 예시는 Chat Completions 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 토큰으로 전송됩니다.
{
"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를 유지하세요.
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를 선택하세요.
{
"$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"
}