VS Code 集成
不离开编辑器即可使用 Venice 模型
OpenAI 兼容
通过 Venice 的
/chat/completions 端点连接模型灵活性
选择任意兼容的 Venice 文本模型
前置条件
- 来自 venice.ai/settings/api 的 Venice API 密钥
- 已安装 Visual Studio Code
- 在 VS Code 中安装了 Cline 扩展
设置
1
打开 Cline 设置
在 VS Code 活动栏中选择 Cline 图标,然后选择齿轮图标以打开 Cline 的设置。
2
选择 API 提供商
将 API Provider 设置为 OpenAI Compatible。
3
配置 Venice
输入以下值:
例如,使用
zai-org-glm-5-1 作为 Model ID。请直接输入 API 密钥本身,不要带 Bearer 前缀。将 Base URL 保持为 /api/v1;Cline 会自行添加 /chat/completions 路径。4
配置模型能力
展开 Model Configuration,将上下文窗口和最大输出 token 数设置为与所选模型匹配。启用该模型支持的能力,包括适用时的图像输入或计算机使用(computer use)。在启用可选能力之前,请在文本模型目录中查看所选模型。
5
保存并测试
保存提供商设置,打开一个项目,交给 Cline 一个小任务,例如:在批准每个文件或命令权限之前请仔细审查。
验证 Venice API
如果 Cline 无法连接,请独立确认 API 密钥和可用的模型 ID:id 完整复制到 Cline 的 Model ID 字段。
配置注意事项
- 使用
https://api.venice.ai/api/v1作为 Base URL,而不是完整的/chat/completions端点。 - 模型 ID 可能会随时间变化。请使用文本模型目录或
GET /models,而不是依赖过时的示例。 - Cline 的上下文窗口和输出 token 设置会影响其对请求的预算分配。为获得最佳结果,请将其与所选模型匹配。
- 请妥善保管您的 Venice API 密钥。不要将其粘贴到源文件或提交到 git。
疑难排查
401 或身份验证错误
401 或身份验证错误
确认 API 密钥来自 venice.ai/settings/api。将原始密钥粘贴到 Cline 中,不要带
Bearer 或多余的空白字符。找不到模型
找不到模型
确认该 Model ID 出现在文本模型目录或
GET /models 的响应中,然后完整复制。连接或端点错误
连接或端点错误
确认 API Provider 为 OpenAI Compatible,且 Base URL 严格为
https://api.venice.ai/api/v1。Cline 无法使用工具或编辑文件
Cline 无法使用工具或编辑文件
打开 Model Configuration,确认所选模型支持所需的能力,如果 Cline 为该模型暴露了 computer use 选项,请予以启用。
资源
Venice Cline 原始指南
阅读 Venice 的官方文章
Venice 文本模型
浏览可用的 Venice 模型 ID
Cline 提供商文档
OpenAI 兼容提供商设置
Venice API 参考
完整端点和参数文档