Skip to content

配置供应商与模型

启动并登录后,点击页面左下角进入管理页面,在其中配置 AI 供应商和模型。

添加供应商

NarraFork 支持所有兼容 OpenAI API 格式的供应商。在管理页面的「供应商」中添加:

  1. 填写供应商名称(自定义,方便识别即可)
  2. 填写 API Base URL(供应商提供的接口地址)
  3. 填写 API Key

NarraFork 独家渠道

NarraFork 提供独家渠道供应商,需前往 https://nkp.domexie.cn 注册并申请 API Key。

添加方式:

  1. NKP 供应商位置输入
  2. API Base URL 填写 https://nkp.domexie.cn
  3. API Key 填写申请到的 Key
  4. 保存配置后,点击「刷新模型」即可获取可用模型列表

添加模型

供应商添加完成后,在「自定义模型」中添加模型:

  1. 填写模型名称(自定义,方便识别即可)
  2. 填写模型 ID — 注意不带供应商前缀,例如使用 claude-sonnet-4-20250514 而不是 anthropic/claude-sonnet-4-20250514
  3. 选择该模型所属的供应商(从已添加的供应商列表中选择)

注意

模型 ID 必须与供应商实际提供的模型标识一致(去掉前缀部分),否则调用会失败。

示例

以接入第三方 OpenAI 兼容服务为例:

配置项示例值
供应商名称My Provider
API Base URLhttps://api.example.com/v1
API Keysk-xxx

对应的模型配置:

配置项示例值
模型名称Claude Sonnet 4
模型 IDclaude-sonnet-4-20250514
所属供应商My Provider

配置完成后,回到项目中即可选择该模型进行对话。

Codex 直连模式

NarraFork 支持 Codex 直连模式,即直接调用 OpenAI 官方 API。由于网络限制,使用该模式需要开启代理(VPN)才能正常连接。

注意

Codex 直连模式要求网络环境能够访问 OpenAI API。如果你所在的地区无法直接访问,请确保已开启代理,否则请求会超时或失败。