跳到正文
RunAPI 开发者文档
EN 中文
开发者资源
开发者资源

NextChat

通过自定义接口和模型将 NextChat 接入 RunAPI。

查看 Markdown

通过自定义 OpenAI 接口将 NextChat 接入 RunAPI。NextChat 拼接 operation path 的方式与本组其他客户端不同，因此请使用下方准确的接口地址。继续前，请先按照身份验证指南创建标准 RunAPI API Key。

安装或部署 NextChat

从 NextChat 官方仓库选择桌面 release 或部署方式，然后打开设置。

配置自定义接口

  1. Web 应用中先启用 Custom Endpoint，并选择 OpenAI；桌面应用始终使用自定义配置。
  2. 接口地址填写 https://runapi.ai，不要附加 /v1。
  3. 填写 RunAPI API Key。
  4. 在 Custom Model Name 中添加模型目录里的准确 identifier，然后为当前对话选择它。

该字段是 NextChat 的接口根地址，不是 OpenAI SDK 使用的 OpenAI-compatible Base URL。NextChat 会自行追加 v1/chat/completions，最终得到 https://runapi.ai/v1/chat/completions。它的 OpenAI client 不会获取 RunAPI 模型列表，因此应手工添加 identifier，而不是等待自动发现。

配置自托管部署

自托管安装可设置以下环境变量，然后重新部署或重启应用：

SHELL 
BASE_URL=https://runapi.ai
OPENAI_API_KEY=YOUR_RUNAPI_API_TOKEN
CUSTOM_MODELS=+YOUR_RUNAPI_MODEL_ID

+ 前缀会添加模型，而不替换应用已有的模型项。

验证连接

新建对话，选择自定义 RunAPI 模型，然后发送只回复 connected。。收到正常的完整或流式响应，即表示自定义接口已生效。

排障

  • 请求 URL 出现 /v1/v1/chat/completions： 从接口地址移除 /v1，使用 https://runapi.ai。
  • NextChat 仍在使用内置模型： 在 Custom Model Name 添加准确 identifier，然后在当前对话中重新选择。
  • Web 设置没有生效： 确认已启用 Custom Endpoint；桌面应用和 Web 应用对此开关的处理不同。
  • 自托管修改没有生效： 修改 BASE_URL、OPENAI_API_KEY 或 CUSTOM_MODELS 后重启或重新部署。

通用协议行为请查阅 LLM API 快速开始，请求和响应字段请查阅 Chat Completions API 参考。