快速入门
发送你的第一个请求
创建 Relay 密钥，设置客户端地址，并从控制台选择可用模型。以下示例演示 Chat Completions 接口。
- 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 Token。Relay 只存储您的 API 密钥的 SHA-256 哈希。
流式传输
设置 stream: true 以获取标准 SSE 数据流。流结束后自动完成余额扣减。
响应格式
非流式响应使用标准 JSON 响应格式,并在响应头中附带 Relay 请求 ID,便于日志查找。
AI 编程工具接入
把常用的 AI 编程工具指向 Relay 网关：复制对应配置到指定文件，替换 sk-relay-your-key 与 YOUR_MODEL_ID 即可。
Claude Code~/.claude/settings.json合并到 ~/.claude/settings.json 的 env 字段，重启 Claude Code 生效。ANTHROPIC_AUTH_TOKEN 会以 Bearer Token 形式发送。Codex~/.codex/config.toml写入 ~/.codex/config.toml，并在 shell 中配置密钥：export RELAY_API_KEY=sk-relay-your-key。Codex 走 Responses 接口，Relay 为无状态转发，必须保留 disable_response_storage。OpenCode~/.config/opencode/opencode.json写入 ~/.config/opencode/opencode.json（或项目根目录 opencode.json），启动后选择模型 relay/YOUR_MODEL_ID。