OpenAI 兼容接口
完整兼容 /v1/chat/completions 等核心端点与官方 SDK，仅替换 base_url 与 Key 即可平滑迁移，无需改造现有代码。
核心特性
轻盈接入，温柔而稳定的 API 中转
兼容官方协议、聚合多家模型、用量可查可对账，让接入与迁移成本降到最低。
多模型聚合
一个 API Key 同时调用 GPT、Claude、Gemini、DeepSeek、Qwen 等多家模型，模型 ID 统一命名，切换只改一个参数。
高并发 · 低延迟
多线路负载均衡与自动故障转移，支持流式输出（SSE），上游异常时自动重试与切换，保障高峰期调用稳定。
按量计费
按输入 / 输出 token 精确结算，支持自定义分组倍率与额度预警，用多少付多少，无最低消费门槛。
透明日志与用量统计
每一次调用的模型、耗时、token 消耗与费用均可在控制台查看，支持按时间维度筛选与导出，方便对账审计。
稳定与安全
令牌独立管理、模型级权限管控、速率限制与异常告警，Key 可随时吊销轮换，中转层不落库保存对话内容。
模型广场
站内已接入的全部模型
模型列表优先从站点接口实时读取；接口不可用时自动展示内置默认清单。
快速接入
三步完成接入，代码无需大改
统一 base_url：https://yunxin.club/v1
1
注册并登录
进入控制台完成注册（如需人工开通，请微信扫码添加客服），登录后可查看可用模型与余额。
2
生成 API 令牌
在控制台「令牌」页面新建令牌，设置可用模型与额度上限，生成 sk- 开头的 Key。
3
替换 base_url 调用
把官方 SDK 的 base_url 指向本站地址，其余参数保持与 OpenAI 官方一致即可。
bash · cURL
curl https://yunxin.club/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {{YOUR_API_KEY}}" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
],
"stream": false
}'
python · openai>=1.0
# pip install openai
import sys
from openai import OpenAI
client = OpenAI(
api_key="{{YOUR_API_KEY}}",
base_url="https://yunxin.club/v1", # 仅需修改这一行
)
stream = client.chat.completions.create(
model="gpt-5.5",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "你好，介绍一下这个接口"},
],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", file=sys.stderr)
javascript · openai@4
// npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "{{YOUR_API_KEY}}",
baseURL: "https://yunxin.club/v1", // 仅需修改这一行
});
const completion = await client.chat.completions.create({
model: "gpt-5.5",
messages: [{ role: "user", content: "你好，介绍一下这个接口" }],
});
console.log(completion.choices[0].message.content);
提示：将 {{YOUR_API_KEY}} 替换为控制台生成的令牌，gpt-5.5 替换为「模型广场」中任意模型 ID。其余端点遵循 OpenAI 兼容协议，可直接套用官方文档。
常见问题
接入前你可能关心的问题
如何开始使用？需要多久？
三步即可：① 通过「控制台登录」完成注册；② 在控制台「令牌」页生成 API Key；③ 把现有代码的 base_url 改为
https://yunxin.club/v1，并使用新 Key 发起调用。熟悉官方 SDK 的用户通常 5 分钟内即可跑通第一条请求。
是否兼容 OpenAI 官方 SDK 和常见客户端？
接口层遵循 OpenAI 兼容协议，官方 Python / Node.js SDK 以及常见第三方客户端（如沉浸式翻译、Chatbox、LobeChat、NextChat 等）均可直接使用，只需填写自定义 base_url 与 API Key。若遇到个别客户端的路径差异，请参考文档或联系管理员。
如何计费？额度怎么充值和查看？
按实际消耗的输入 / 输出 token 结算，具体单价与额度倍率请以控制台说明为准。充值方式与到账规则请以控制台说明为准；控制台的「用量统计」与「日志」页可实时查看余额、消费明细与每一笔调用记录，支持按时间筛选导出，便于对账。
支持哪些模型？模型会持续更新吗？
目前覆盖 GPT、Claude、Gemini、DeepSeek、Qwen 等主流厂商的常用模型，完整清单见上方「模型广场」（实时读取站内已接入模型）。上游发布新模型后本站会陆续跟进上架，模型 ID 命名尽量与官方保持一致，便于随时切换。
调用失败或返回超时怎么办？
中转层已内置多线路重试与自动故障转移，偶发超时通常会自动恢复。若持续失败，请先在控制台日志中确认错误码：
401 一般是 Key 错误或已吊销，429 表示触发速率限制，5xx 多为上游波动，可稍后重试。仍无法解决时请通过页脚联系方式反馈，并附上请求时间与错误详情。
我的数据安全吗？对话内容会被保留吗？
中转层仅做协议转发与用量计量，不作为数据用途存储你的对话正文；控制台日志仅记录模型、耗时、token 消耗等计量信息。令牌支持随时吊销与轮换，建议为不同业务分配独立令牌并设置模型白名单与额度上限，降低泄露风险。