MonkeyCode接入自定义DeepSeek模型实战文档

文档版本：V1.0
适用环境：MonkeyCode网页版（百智云），兼容OpenAI协议的DeepSeek官方API；同时支持vLLM/Ollama本地私有化DeepSeek模型。
阅读对象：开发人员，用于Agent代码分析、方案生成、自动化工程任务。

一、背景

在日常使用MonkeyCode做项目开发时，平台提供的免费Token、积分额度经常会被快速耗尽。一旦额度用尽，项目迭代、Bug排查、自动化Agent任务就会被迫中断，直接影响项目推进节奏。
针对该痛点，MonkeyCode支持接入自定义大模型，我们可以绑定自己申请的DeepSeek开放平台API Key。调用不再消耗平台积分，全部计费走个人DeepSeek账号余额，保证项目可以不受平台额度限制持续推进。

二、原理说明

MonkeyCode支持标准OpenAI‑Chat兼容接口协议，DeepSeek官方API原生兼容该协议，因此可以直接填入接口地址与密钥，将DeepSeek作为底层推理大脑。

• 平台内置DeepSeek：消耗MonkeyCode平台积分
• 自定义绑定DeepSeek：消耗个人DeepSeek账号余额

拓展：同样配置逻辑，也可对接本地vLLM/Ollama部署的DeepSeek私有推理服务。

三、前置准备

1. 注册登录 DeepSeek开放平台：https://platform.deepseek.com/
2. 在平台创建API‑Key，复制并妥善保存密钥（密钥仅展示一次，关闭页面后无法再次查看）
3. 网络环境可正常访问DeepSeek官方API接口
4. 已登录MonkeyCode网页版（百智云）账号

DeepSeek官方云端关键配置参数

配置项	填写值
接口协议	OpenAI Chat
API Base地址	https://api.deepseek.com/v1
API Key	sk‑xxxxxxxx（个人密钥）
推荐模型ID	deepseek‑v4‑flash（Agent开发首选，性价比高） deepseek‑v4‑pro（复杂逻辑、大规模方案分析）
最大上下文	128000

本地vLLM/Ollama部署场景：API Base改为本地地址如http://127.0.0.1:8000/v1，API Key填写任意占位字符串即可。

四、网页版MonkeyCode绑定DeepSeek自定义模型步骤

1. 登录 MonkeyCode（百智云）网页控制台
2. 页面左下角点击【配置】齿轮图标 → 选择【AI大模型】
3. 点击【绑定】，弹出新增自定义模型弹窗
4. 逐项填写参数：
   • 接口模式：选择 OpenAI‑Chat
   • 模型API地址：https://api.deepseek.com/v1
   • API Token：粘贴DeepSeek平台复制的 sk‑xxxx密钥
   • 模型名称：填写 deepseek‑v4‑flash
   • 模型备注：自定义，例如 DeepSeek‑V4‑Flash(个人密钥)
5. 高级设置（可选）
   • 上下文窗口：128000
   • 最大输出长度：8192
   • temperature温度：代码Agent建议填0.3‑0.4，降低输出随机性
6. 点击【保存】，模型列表出现新增自定义模型，代表配置完成。

⚠️保存失败常见坑：API Base地址末尾必须带上/v1；密钥不要带多余空格、换行符。

五、任务中切换使用自定义DeepSeek模型

1. 新建【智能任务】
2. 在任务弹窗的模型下拉列表，选中刚刚新增的自定义模型
3. 填写任务提示词，执行任务。

✅生效验证：请求直接转发至DeepSeek官方接口，Token消耗可在DeepSeek开放平台控制台的用量统计页面查看。

六、本地私有化DeepSeek模型接入拓展（vLLM / Ollama）

如果你本地显卡部署了DeepSeek‑Coder / V4‑Flash，通过vLLM启动OpenAI兼容本地API服务：

• API Base：http://127.0.0.1:8000/v1
• API Token：任意字符串（本地服务无需鉴权）
• 模型名称：填写vLLM启动时指定的模型名称

⚠️重要限制：网页版MonkeyCode属于云端服务，无法直接访问本机127.0.0.1本地地址。本地模型仅可在私有化部署版MonkeyCode中使用；网页版若要调用本地API需要公网暴露，存在安全风险，不建议普通开发者使用。

七、安全与开发注意事项

7.1 密钥安全

1. API‑Key严禁泄露，不要写进提示词、不要截图分享。密钥泄露会导致他人盗用你的账号余额。
2. 怀疑密钥泄露时，立刻在DeepSeek平台删除旧Key，重新生成新密钥。
3. MonkeyCode仅做接口透传转发，密钥保存在用户个人账号配置内。

7.2 Agent开发适配要点

1. 优先选择deepseek‑v4‑flash，MoE激活推理，成本可控，工具调用能力适配MonkeyCode Agent循环任务。
2. Agent多轮循环执行git、文件读取、调试任务会持续消耗大量Token，建议在DeepSeek平台设置消费告警阈值，避免超额扣费。
3. 旧别名deepseek‑chat官方已经废弃，禁止使用，务必填写完整模型ID：deepseek‑v4‑flash / deepseek‑v4‑pro。

八、常见故障排查

故障现象	排查方案
调用报错401 Unauthorized	API Key复制错误、存在多余空格；确认密钥未被平台删除
429 Too Many Requests	触发DeepSeek接口限流，降低任务并发，查看平台配额上限
任务执行失败无明确报错	确认API Base末尾带/v1；模型ID拼写完全一致；确认网络可访问DeepSeek接口
Agent工具调用失效	优先使用v4‑flash模型；temperature调低至0.4以下
保存后看不到新增模型	保存完成后刷新页面，确认配置已成功保存

九、平台内置模型 vs 自定义DeepSeek模型对比

项目	平台内置DeepSeek	自定义绑定DeepSeek
计费来源	消耗MonkeyCode平台积分	消耗个人DeepSeek账号余额
密钥管理	平台托管	开发者自行保管API‑Key
模型版本	平台统一维护更新	开发者自主选择模型版本
用量统计	MonkeyCode内部统计	DeepSeek开放平台提供细粒度用量明细
本地模型支持	❌不支持	✅私有化部署版MonkeyCode支持

十、附录：curl测试脚本

配置完成后，可先用curl本地验证API Key是否正常，接口通了再接入MonkeyCode。

curl https://api.deepseek.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk‑你的密钥" \
  -d '{
    "model":"deepseek‑v4‑flash",
    "messages":[{"role":"user","content":"hello"}],
    "max_tokens":100
  }'