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

Jan

将 RunAPI 添加为 Jan 服务商并验证对话。

通过自定义 OpenAI-compatible 服务商将 Jan 接入 RunAPI。继续前,请先按照身份验证指南创建标准 RunAPI API Key。

安装 Jan

Jan 官方网站下载并安装桌面应用,然后打开设置。

添加 RunAPI 服务商

  1. 打开 Settings -> Model Providers -> Add Provider
  2. API format 选择 OpenAI-compatible,Provider name 填写 RunAPI
  3. Base URL 设为 https://runapi.ai/v1,填写 RunAPI API Key,然后创建服务商。
  4. 选择自动发现的模型,或者在服务商的 Models 区域手工添加模型目录里的准确 identifier。

这里选择的是 OpenAI-compatible API format,因此 Base URL 包含 /v1;使用其他公开协议的服务商时,应按对应协议的客户端配置填写。

保存服务商时,Jan 会请求 {base_url}/models,对应 https://runapi.ai/v1/models。如果没有返回所需模型,请使用手工 + 操作,不要修改 Base URL。

配置模型能力

Jan 不会为自定义服务商推断所有能力。只启用所选模型在模型目录中声明的 vision、tools 或 audio 行为;UI 开关不能增加 API 原本不支持的能力。

验证连接

新建对话,选择 RunAPI 模型,然后发送只回复 connected。。收到正常的完整或流式响应,即表示服务商和模型已生效。

排障

  • 所有请求都返回 404 确保 Base URL 包含 /v1;Jan 会继续追加 operation path。
  • 没有出现模型: 确认 Base URL 是 https://runapi.ai/v1,然后手工添加准确 identifier。
  • 创建服务商时返回 401403 换用有效的标准 RunAPI API Key,不要使用 Management Key。
  • 能力控件与模型不匹配: 按每个自定义模型声明的真实能力配置,不要依赖自动探测。
  • 没有尝试备用 Key: Jan 只会在 401403429 时轮换 Key,其他错误不会触发 Key rotation。

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