配置供应商与模型
启动并登录后,点击页面左下角进入管理页面,在其中配置 AI 供应商和模型。
添加供应商
NarraFork 支持所有兼容 OpenAI API 格式的供应商。在管理页面的「供应商」中添加:
- 填写供应商名称(自定义,方便识别即可)
- 填写 API Base URL(供应商提供的接口地址)
- 填写 API Key
NarraFork 独家渠道
NarraFork 提供独家渠道供应商,需前往 https://nkp.domexie.cn 注册并申请 API Key。
添加方式:
- 在 NKP 供应商位置输入
- API Base URL 填写
https://nkp.domexie.cn - API Key 填写申请到的 Key
- 保存配置后,点击「刷新模型」即可获取可用模型列表
添加模型
供应商添加完成后,在「自定义模型」中添加模型:
- 填写模型名称(自定义,方便识别即可)
- 填写模型 ID — 注意不带供应商前缀,例如使用
claude-sonnet-4-20250514而不是anthropic/claude-sonnet-4-20250514 - 选择该模型所属的供应商(从已添加的供应商列表中选择)
注意
模型 ID 必须与供应商实际提供的模型标识一致(去掉前缀部分),否则调用会失败。
示例
以接入第三方 OpenAI 兼容服务为例:
| 配置项 | 示例值 |
|---|---|
| 供应商名称 | My Provider |
| API Base URL | https://api.example.com/v1 |
| API Key | sk-xxx |
对应的模型配置:
| 配置项 | 示例值 |
|---|---|
| 模型名称 | Claude Sonnet 4 |
| 模型 ID | claude-sonnet-4-20250514 |
| 所属供应商 | My Provider |
配置完成后,回到项目中即可选择该模型进行对话。
Codex 直连模式
NarraFork 支持 Codex 直连模式,即直接调用 OpenAI 官方 API。由于网络限制,使用该模式需要开启代理(VPN)才能正常连接。
注意
Codex 直连模式要求网络环境能够访问 OpenAI API。如果你所在的地区无法直接访问,请确保已开启代理,否则请求会超时或失败。