原生提供商
Kilo 的 Providers 设置中内置 Venice 支持
VS Code + CLI
同一份
kilo.json 配置在扩展和 CLI 中通用推理模型
当模型支持时,Kilo 会映射 Venice 的推理控制项
前置条件
- 来自 venice.ai/settings/api 的 Venice API 密钥
- Kilo Code for VS Code 和/或 Kilo CLI
设置
- VS Code
- CLI
1
安装 Kilo Code
在 VS Code 中打开扩展,搜索 Kilo Code,并从 Visual Studio Marketplace 安装。当 Marketplace 的**预发布(Pre-Release)**通道是当前推荐版本时,请优先使用该通道 —— 参见 Kilo 的安装文档。
2
获取 Venice API 密钥
在 venice.ai/settings/api 生成密钥。请立即复制并妥善保存。
3
添加 Venice 提供商
打开 Kilo 的设置(齿轮图标),进入 Providers 标签页。选择 Venice AI 并粘贴您的 Venice API 密钥。扩展会将提供商信息保存到您的
kilo.json 配置中。您也可以直接编辑该文件 —— 格式参见 CLI 标签页。4
选择模型并测试
验证 Venice API
如果 Kilo 无法连接,请独立确认 API 密钥和模型 ID:id 完整复制到 Kilo 中。在 CLI 配置中,请为其加上 venice/ 前缀,例如 venice/zai-org-glm-5-1。
配置注意事项
- Venice 是 Kilo 的原生提供商。请优先在 Providers 设置中选择 Venice AI,而不是使用通用的兼容 OpenAI 自定义端点。
- 扩展和 CLI 共享相同的配置文件(全局的
~/.config/kilo/kilo.json,或项目中的./kilo.json)。 - 部分 Venice 模型暴露了推理控制项。当所选模型支持时,Kilo 会映射对应的推理强度(reasoning effort)和禁用思考(disable-thinking)选项。
- 模型 ID 和套餐权限可能会变化。请使用模型选择器、文本模型目录或
GET /models获取最新列表。 - 请妥善保管您的 Venice API 密钥。不要将其粘贴到源文件或提交到 git。
疑难排查
API 密钥无效或 401
API 密钥无效或 401
确认密钥来自 venice.ai/settings/api。使用 CLI 时,请验证
VENICE_API_KEY 已在启动 Kilo 的同一环境中设置。在 VS Code 中,请在 Providers 下重新连接 Venice AI。模型不可用
模型不可用
确认您的 Venice 账户有权访问所选模型,从文本模型目录或
GET /models 中复制该 ID,并在 CLI 配置中使用 venice/<model-id> 形式。扩展中找不到 Provider 设置
扩展中找不到 Provider 设置
请更新到 Kilo 当前推荐的版本(当预发布是文档默认版本时也应包含在内)。您也可以按 CLI 标签页所示在
kilo.json 中设置提供商 —— 扩展读取的是相同的配置。资源
Kilo Venice Provider Docs
Kilo Code 官方 Venice 设置文档
Venice 文本模型
浏览可用的 Venice 模型 ID
Kilo 安装文档
VS Code、CLI 及其他平台
Venice API 参考
完整端点和参数文档