接入到 Astrbot

本教程将引导您如何将 灵息 API 接入到 Astrbot，实现强大的 AI 对话能力。

1. 进入模型提供商界面

首先，打开您的 Astrbot 管理后台。通常情况下，访问地址为： http://您的服务器IP:端口/#/providers

在页面中找到并点击 “新增” 按钮。

2. 选择接入协议

在弹出的提供商类型中，选择以下之一（两者均兼容灵息 API 格式）：

• OpenAI (推荐)
• Ollama (若 OpenAI 选项不可用时使用)

3. 配置关键参数

选择协议后，在右侧的配置面板中填写以下信息。请务必逐字符核对，避免配置失败。

参数项	填写内容	注意事项
API Key	您从灵息后台获取的 sk-xxx	确保没有前后空格
API Base URL	https://ask.ling.rest/api/v1	严禁在末尾添加多余的斜杠 /

⚠️ 避坑提醒

如果填写错误（如漏掉 /api/v1 或多加了斜杠），Astrbot 可能会返回 403 Forbidden 或 404 Not Found。请严格对照上述表格填写。

4. 获取并添加模型

1. 填写完参数后，点击底部的 “保存并获取模型”。
2. 如果配置正确，Astrbot 会自动列出灵息 API 支持的所有模型列表。
3. 点击模型旁边的 “+” 号，将其添加到您的可用模型库中。

5. 测试连通性

添加模型后，建议进行一次连通性测试：

• 测试方式：在 Astrbot 界面点击“测试连通性”按钮。
• 注意事项：由于部分模型（尤其是逆向模型）可能存在临时波动，如果测试失败，建议先去 API 测试场 或灵息网页版确认该模型是否正常工作。

6. 常见问题排查

• 报错 403 / 401：
  • 请检查 API Key 是否填写正确。
  • 检查 Base URL 是否包含了完整的 /api/v1 路径且没有尾斜杠。
• 获取不到模型列表：
  • 检查您的账号余额是否充足。
  • 检查服务器网络是否能够正常访问 https://ask.ling.rest。
• 响应速度慢：
  • 如果您选择的是“逆向”系列模型，响应慢属正常现象。生产环境建议选择非逆向系列模型。

下一步建议

配置完成后，您可以前往 模型介绍 了解不同模型系列的优缺点，以便为您的机器人选择最合适的“大脑”。