开发者资源
Jan
将 RunAPI 添加为 Jan 服务商并验证对话。
通过自定义 OpenAI-compatible 服务商将 Jan 接入 RunAPI。继续前,请先按照身份验证指南创建标准 RunAPI API Key。
安装 Jan
从 Jan 官方网站下载并安装桌面应用,然后打开设置。
添加 RunAPI 服务商
- 打开 Settings -> Model Providers -> Add Provider。
- API format 选择 OpenAI-compatible,Provider name 填写
RunAPI。 - Base URL 设为
https://runapi.ai/v1,填写 RunAPI API Key,然后创建服务商。 - 选择自动发现的模型,或者在服务商的 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。 - 创建服务商时返回
401或403: 换用有效的标准 RunAPI API Key,不要使用 Management Key。 - 能力控件与模型不匹配: 按每个自定义模型声明的真实能力配置,不要依赖自动探测。
- 没有尝试备用 Key: Jan 只会在
401、403或429时轮换 Key,其他错误不会触发 Key rotation。
通用协议行为请查阅 LLM API 快速开始,请求和响应字段请查阅 Chat Completions API 参考。