Docs

RelayHub OpenAI 兼容接入

这里已经整理成首版可用的接入文档，覆盖基础地址、认证方式、SDK 示例和调试顺序，用户复制后就可以开始联调。

API Base URL

https://api.fastapi.uk/v1

认证 Header

Authorization: Bearer sk-xxxx

最新公告

当前暂无公告，接入文档已可用于基础调试。

推荐接入顺序

1. 登录控制台创建用户自己的 API Key

2. 先调用 `/v1/models` 验证网络和鉴权

3. 再调用 `/v1/chat/completions` 或 `/v1/responses`

4. 最后回到账单页检查额度是否扣减成功

Quick Start

curl https://api.fastapi.uk/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'

SDK Recipes

常用客户端接入示例

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.fastapi.uk/v1",
  apiKey: "sk-xxxx"
});

const result = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "Hello" }]
});

console.log(result.choices[0]?.message?.content);

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.fastapi.uk/v1",
    api_key="sk-xxxx",
)

result = client.responses.create(
    model="gpt-5.4",
    input="Hello"
)

print(result.output_text)

Checklist

联调检查清单

1. 账号准备

登录用户端后，先创建自己的 API Key，不要直接把平台固定 Key 当成用户调用密钥。

2. 地址配置

客户端的 `baseURL` 或 `base_url` 统一填写为 https://api.fastapi.uk/v1。

3. 模型验证

建议先请求 `/v1/models`，这样可以快速区分是鉴权问题、地址问题还是业务请求本身的问题。

4. 额度检查

请求成功后回到账单页和调用记录页，确认额度扣减和请求日志都已写入。

Available Endpoints

GET /v1/models模型探活
POST /v1/chat/completions对话兼容接口
POST /v1/responsesResponses 接口

Supported Models

当前开放模型

Model Notes

模型说明

错误码说明

常见错误码

401鉴权失败

请检查 `Authorization: Bearer <你的 API Key>` 是否正确，确认 Key 仍处于 active。

402额度不足

用户余额不足时请先充值兑换码，再重新发起请求。

429频率过高

稍后重试，或联系管理员确认是否触发限流策略。

5xx上游或网关异常

优先检查 `/v1/models` 是否正常，再查看调用记录中的错误信息。

Client Guides

分平台接入教程

Cursor

打开 Cursor 的模型或 OpenAI 兼容配置页面。

将 Base URL 填写为 https://api.fastapi.uk/v1。

将 API Key 填写为你在用户端创建的 sk-xxxx 格式密钥。

先用模型列表或一次最小请求测试连通性，再开始正式接入。

Continue

在 Continue 的 provider 配置中选择 OpenAI 兼容接口。

把 baseUrl 指向 https://api.fastapi.uk/v1。

填入用户自己的 API Key，不要直接复用平台固定环境变量。

联调成功后回到账单页和调用记录页，确认请求写入和额度扣减。

OpenAI SDK

JavaScript 使用 `baseURL`，Python 使用 `base_url` 指向平台 `/v1` 地址。

优先使用 `/v1/models`、`/v1/chat/completions`、`/v1/responses` 三条链路做最小验证。

如果模型名调整，以平台实际开放模型列表为准。

Support

排查仍未解决时

建议附带的信息

提交模型名、请求时间、状态码、错误信息，以及你在调用记录页看到的对应记录。

联系客服

请联系站点客服

最小排查路径

先测 `/v1/models`，再测一个最小 `chat.completions` 请求，最后回到调用记录和账单页交叉确认。