Skip to content

开启 API / 局域网(KoboldCPP)

版本界面文案可能不同,请以你安装的 KoboldCPP 为准;目标是:

  1. 开启 OpenAI Compatible / Chat Completions API
  2. 监听地址允许局域网(不要只绑 localhost)
  3. 防火墙放行端口

常见默认

常见值
端口5001(以启动参数 / UI 显示为准)
Base URL(给 MiniTavern)http://YOUR_PC_IP:5001/v1

部分版本用启动参数,例如(示例,请对照当前文档):

bash
# 示意:开启远程访问与 OpenAI 兼容端点(具体 flag 以官方 README 为准)
koboldcpp --model your.gguf --host 0.0.0.0 --port 5001

本机自测

浏览器或 curl:

text
http://127.0.0.1:5001/v1/models

能看到模型列表再测局域网:

text
http://YOUR_PC_IP:5001/v1/models

给 MiniTavern 填写

字段填写
模型平台自定义(OpenAI 兼容)
Base URLhttp://YOUR_PC_IP:5001/v1
API Key通常可留空或任意占位
模型名/v1/models 返回的 id 一致

下一步

在 MiniTavern 中配置 · 排错