接入指南

选择支持的工具与接口，填写服务地址、个人密钥和可用模型标识。不同模型的接口兼容范围可能不同。

先确认费用，再测试接入。

主站与 Relay 分别登录。个人密钥绑定的分组决定可用模型和适用规则。

模型与实际价格 →

开始前

在模型与价格页确认能力、单位和适用分组。
登录个人控制台，创建密钥；查看余额、额度与计费方式。
向工具填入下方地址、个人密钥与可用模型 ID。
先做一次小规模测试，再到控制台核对用量。

基础地址

接口地址：https://relay.lztlink.cn/v1

需要按截图操作？查看主站图文接入教程 ↗（需登录主站）。截图用于说明操作位置，地址、模型和价格以当前页面为准。

认证

登录个人控制台，在密钥区创建并命名自己的接入密钥。请求使用 Authorization: Bearer 你的个人密钥。不要使用管理员或上游供应商密钥接入普通工具。

Python

OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://relay.lztlink.cn/v1",
    api_key="你的个人密钥",
)

resp = client.chat.completions.create(
    model="替换为你的可用模型ID",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in resp:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

curl

Chat Completions

curl https://relay.lztlink.cn/v1/chat/completions \
  -H "Authorization: Bearer 你的个人密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为你的可用模型ID",
    "messages": [{"role": "user", "content": "你好"}]
  }'

可用接口

GET /v1/models - 聚合组内账号的模型列表
POST /v1/chat/completions - 对话补全，支持 SSE 流式
POST /v1/completions - 文本补全
POST /v1/embeddings - 向量
其它 /v1/* 请求会原样转发到组内上游

注册与个人密钥

公开注册开启时，用户访问 /register 创建账号。登录个人控制台后查看或创建自己的密钥。密钥所属分组与模型权限以控制台实际设置为准。

费用与排查

实际报价与美元目录参考价分开展示；分组或渠道差异会形成价格范围。请求成功后查看账单中的用量、单价和实际扣费。异步任务应查询最终状态。

401：核对密钥是否正确、有效。
402：核对余额或调用额度。
404：核对模型标识、分组权限与接口路径。
429：等待后重试，或降低请求频率与并发。
超时或结果传输中断：先检查任务与调用记录，避免反复提交同一生成任务。

分组路由

分组内账号按优先级排序，同优先级下按权重选择。当前账号连接失败、超时、429 或 5xx 时，自动尝试下一个可用账号。分组可配置模型白名单，未在白名单内的模型返回 404。