𝐗𝐀𝐈

LightVela 接入 XAI / YAI / ZAI Router 指南

Posted June 15, 2026 by XAI 技术团队 ‐ 7 min read

本文介绍如何在 LightVela 中通过 Router API 接入 XAI Router、YAI Router 或 ZAI Router，让 LightVela 的云端智能体使用统一模型入口。

本文介绍如何在 LightVela 中通过 Router API 接入 XAI Router、YAI Router 或 ZAI Router，让 LightVela 的云端智能体使用统一模型入口。

适用场景

如果你希望在 LightVela 中统一使用 OpenAI、Claude、Gemini、DeepSeek、Grok 等模型，可以把 XAI Router、YAI Router 或 ZAI Router 作为 LightVela 的自定义模型服务商来配置。配置完成后，LightVela 只需要保存一个 Router API Key 和一个模型入口，后续模型请求由对应 Router 路由到目标模型。

XAI Router 官方文档说明其提供统一 Base URL：https://api.xairouter.com，并支持 OpenAI、Claude、Gemini 等兼容协议。YAI Router 的接入点为 https://api.yairouter.com，ZAI Router 的接入点为 https://api.zairouter.com。LightVela 的模型配置页支持自定义 Provider、Base URL、兼容协议、API Key 和模型信息，因此可以直接接入。

选择接入点

请根据你实际使用的账号和 API Key 选择对应接入点。不要混用不同站点的 API Key 和 Base URL。

使用的服务Base URLProvider 建议填写
XAI Routerhttps://api.xairouter.comxairouter
YAI Routerhttps://api.yairouter.comyairouter
ZAI Routerhttps://api.zairouter.comzairouter

说明：https://api.xairouter.com 已兼容 Base URL 带 /v1 或不带 /v1 的写法。为了减少配置差异，本文统一使用不带 /v1 的 Base URL。若你的后台、客服或团队配置给出了特定地址，请以实际接入点为准。

准备工作

  1. 注册 Router 账号 根据你使用的服务，打开对应后台注册并完成账号激活。XAI Router 可打开 m.xairouter.com。

  2. 获取 Router API Key 注册完成后，在对应 Router 后台或系统邮件中获取 API Key。后续在 LightVela 中填写这个 Key。

  3. 确认要使用的模型 ID 不同接入点的模型权限可能不同，请以你实际使用的 Router 后台或团队给出的模型列表为准。常见示例：

    • gpt-5.4-mini
    • gpt-5.4
    • gpt-5.5

推荐配置：OpenAI Completions 兼容

这是最推荐的接入方式，适合大多数 LightVela 场景。

进入 LightVela 控制台后，打开你的智能体，进入：

模型 → 自定义模型 或 添加自定义模型

按下面填写：

字段填写内容
Provider使用 XAI Router 填 xairouter；使用 YAI Router 填 yairouter；使用 ZAI Router 填 zairouter
Base URL使用 XAI Router 填 https://api.xairouter.com；使用 YAI Router 填 https://api.yairouter.com；使用 ZAI Router 填 https://api.zairouter.com
兼容协议OpenAI Completions
API Key你的 Router API Key，例如 sk-xxx
模型 ID例如 gpt-5.4-mini
模型名称可填写便于识别的名称，例如 gpt-5.4-mini

保存后，将当前模型切换到刚刚创建的模型配置。

Claude 兼容模型配置

如果你要接入 Claude 模型，也可以使用 Anthropic Messages 兼容协议：

字段填写内容
Provider使用 XAI Router 可填 xairouter-claude；使用 YAI Router 可填 yairouter-claude；使用 ZAI Router 可填 zairouter-claude
Base URL使用 XAI Router 填 https://api.xairouter.com；使用 YAI Router 填 https://api.yairouter.com；使用 ZAI Router 填 https://api.zairouter.com
兼容协议Anthropic Messages
API Key你的 Router API Key
模型 ID例如 claude-opus-4-6
模型名称例如 claude-opus-4-6

说明：这里推荐填写不带 /v1 的 Base URL。XAI Router 已兼容 /v1 有或没有的情况；如果你使用的是 YAI Router 或 ZAI Router，则把示例中的 XAI 接入点替换成对应接入点即可。

验证是否接入成功

保存模型配置后，回到 LightVela 的对话或测试工作台，发送一条简单消息：

你好，请用一句话介绍你自己。

如果模型正常回复，说明接入成功。

也可以在对应 Router 后台查看用量记录，确认请求已经通过正确的接入点发出。

常见问题

1. Base URL 应该填哪个？

请根据自己的接入点填写：

使用的服务推荐 Base URL
XAI Routerhttps://api.xairouter.com
YAI Routerhttps://api.yairouter.com
ZAI Routerhttps://api.zairouter.com

/v1 可以不写。https://api.xairouter.com 已经兼容带 /v1 和不带 /v1 的写法；为了便于排查问题，建议文档和团队配置统一使用不带 /v1 的形式。

2. API Key 填谁的？

填写对应 Router 分配给你的 API Key，不是 OpenAI、Anthropic 或 Gemini 原厂 Key。使用 XAI Router 的 Key 就配 https://api.xairouter.com；使用 YAI Router 的 Key 就配 https://api.yairouter.com；使用 ZAI Router 的 Key 就配 https://api.zairouter.com。

3. 模型 ID 填错会怎样？

如果模型 ID 不存在或当前账号无权使用，LightVela 可能会提示模型调用失败。请到对应 Router 的模型列表确认模型 ID。

4. 保存后仍然不可用怎么办？

依次检查：

  1. API Key 是否完整，没有多余空格。
  2. Base URL 是否和你的 API Key 属于同一个接入点。
  3. 模型 ID 是否在对应 Router 中可用。
  4. Router 账号是否有余额或有效套餐。
  5. LightVela 当前智能体是否已经切换到新建的模型配置。

参考链接