Docs / 快速开始

快速开始

获取你的 API 密钥，在 2 分钟内完成你的第一次 API 调用。

#基本信息

字段	值
`API 基础 URL`	`https://relayrouter.io/v1`
`API 密钥`	从控制台获取，格式：`sk-xxxxxxxxxxxx`
`支持的协议`	兼容 OpenAI API / 兼容 Anthropic API / 兼容 Gemini API

#第 1 步：创建账户

注册一个 RelayRouter 账户，并充值任意金额即可开始发起请求。

#第 2 步：获取 API 密钥

打开控制台，进入 API 密钥页面
创建一个新密钥
复制并妥善保存

切勿把密钥提交到版本控制系统。请将其保存在环境变量中，例如 RELAYROUTER_API_KEY。

#第 3 步：安装 SDK

任何兼容 OpenAI 的客户端都可以使用。官方 OpenAI SDK 是最快的上手方式：

terminalbash

# Node.js
npm install openai

# Python
pip install openai

#第 4 步：发起你的第一次对话调用

该 API 兼容 OpenAI。如果你已经在用 OpenAI SDK，只需改一下基础 URL 和 API 密钥，其余无需改动。

Python

TypeScript

cURL

main.pypython

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["RELAYROUTER_API_KEY"],
    base_url="https://relayrouter.io/v1",
)

response = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "Hello! What can you do?"}],
)
print(response.choices[0].message.content)

#更喜欢 Anthropic SDK？原生即可使用

网关在 POST /v1/messages 上同样支持 Anthropic 协议，因此官方 Anthropic SDK 无需适配器即可使用：把 base_url 设为 https://relayrouter.io，代码保持不变即可。Gemini 风格的 /v1beta 端点也同样可用。

anthropic_sdk.pypython

import anthropic

client = anthropic.Anthropic(
    api_key="your-relayrouter-key",
    base_url="https://relayrouter.io",
)
msg = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(msg.content[0].text)

#第 5 步：试试另一个模型

切换供应商只需改一个参数。可使用你密钥模型列表中的任意模型 ID：

terminalbash

curl https://relayrouter.io/v1/chat/completions \
  -H "Authorization: Bearer $RELAYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

用 GET https://relayrouter.io/v1/models 列出你密钥可用的模型，或浏览模型页面。

#下一步

API 密钥 : 为开发和生产分别管理密钥
LLM / 对话 : 流式输出、工具调用、系统提示词
图像生成 : 通过 /v1/images/generations 实现文生图
SDK 与框架 : LangChain、LiteLLM 等集成方案