RelayAB
登录

接入文档

用任何 OpenAI / Anthropic 兼容的客户端即可调用本服务，下面给出示例与可复制的 URL。

接入文档

用任何 OpenAI / Anthropic 兼容的客户端即可调用本服务，下面给出示例与可复制的 URL。

基本概念

本服务提供兼容 OpenAI Chat Completions / Responses 与 Anthropic Messages 的接口。

你只需要关心三件事：

  1. 服务的 Base URL（下面会列出）
  2. 你在 /dashboard 自己创建的 API Key（以 sk-relay- 开头）
  3. Authorization: Bearer <你的 Key> 这个 HTTP 请求头
请把 Key 视为密码妥善保管。Key 一旦丢失，无法找回明文，请停用并重新创建。

服务地址

在客户端的 Base URL / endpoint 字段填入下列地址。

服务公网地址
https://api.aasim.l.cd
OpenAI 兼容 Base URL
https://api.aasim.l.cd/v1
Anthropic 兼容 Base URL
https://api.aasim.l.cd/anthropic

OpenAI Chat Completions

兼容 /v1/chat/completions。

按下面三步即可发起一次聊天补全请求：

Base URL
https://api.aasim.l.cd/v1
认证头
Authorization: Bearer sk-relay-xxxx...
curl 示例
curl https://api.aasim.l.cd/v1/chat/completions \
  -H "Authorization: Bearer $RELAYAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

想知道你能用哪些模型？GET ${baseUrl}/models，参考你的 Key 关联的模型映射。

Anthropic Messages

兼容 /anthropic/v1/messages。

Anthropic SDK 默认走 https://api.anthropic.com，需要手动把 baseURL 改成下面的值。

Base URL
https://api.aasim.l.cd/anthropic
认证头（使用 x-api-key 而非 Authorization）
x-api-key: sk-relay-xxxx...
curl 示例
curl https://api.aasim.l.cd/anthropic/v1/messages \
  -H "x-api-key: $RELAYAB_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

SDK 会自动请求 <baseURL>/v1/messages，所以 baseURL 只填到 /anthropic，后面不要再带 /v1。

Anthropic SDK 示例
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.RELAYAB_KEY,   // your RelayAB key
  baseURL: "https://api.aasim.l.cd/anthropic",       // no trailing /v1
});

const msg = await client.messages.create({
  model: "YOUR_MODEL_ID",            // from GET /v1/models
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(msg.content);

模型名称与映射

客户端能填哪些模型名，由管理员在 Provider 的模型映射里决定。

客户端能用的模型名 = GET /v1/models 返回的 id，直接照抄即可。

  • 这些名字只是别名，不一定等于上游厂商的真实模型名，不要按名字猜测背后是哪家模型。
  • 如果客户端只认固定模型名（例如 Claude Code 只接受 claude-*），请联系管理员在 Provider 里加映射，或改用客户端自己的模型覆盖项（如 ANTHROPIC_MODEL）。
列出可用模型
curl -H "Authorization: Bearer $RELAYAB_KEY" https://api.aasim.l.cd/v1/models

OpenAI Responses API

兼容 /v1/responses。

Responses API 是 OpenAI 最新的一体化 API，使用与 Chat Completions 相同的 Base URL。

Base URL
https://api.aasim.l.cd/v1
认证头
Authorization: Bearer sk-relay-xxxx...
curl 示例
curl https://api.aasim.l.cd/v1/responses \
  -H "Authorization: Bearer $RELAYAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "Hello!"
  }'

Python 集成

使用官方 openai Python SDK，3 行就能跑起来：

openai-python
from openai import OpenAI

client = OpenAI(
    api_key="sk-relay-xxxx...",          # your RelayAB key
    base_url="https://api.aasim.l.cd/v1",             # point at THIS instance
)

resp = client.chat.completions.create(
    model="YOUR_MODEL_ID",               # from GET /v1/models
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

Node.js 集成

使用官方 openai Node SDK：

openai-node
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.RELAYAB_KEY,        // your RelayAB key
  baseURL: "https://api.aasim.l.cd/v1",               // point at THIS instance
});

const resp = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",   // from GET /v1/models
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

还有疑问？联系你的管理员。