Qoder接入自定义大模型需严格匹配三种API格式：OpenAI兼容格式（填Base URL和API Key）、阿里云百炼原生格式（选Region、填Model Name和API Key）、MCP协议格式（手动配置JSON并验证服务健康）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Qoder中正确接入自定义大模型，必须先选对API格式——填错会导致添加失败、对话无响应或Token持续扣减却无输出。Qoder不接受裸HTTP地址或非标准格式的密钥，只认三种明确协议类型，且每种对应不同的服务商和认证逻辑。
确认你用的是哪家模型服务商
阿里云百炼、火山引擎、讯飞星火、月之暗面等主流平台，各自提供不同协议格式的API端点。Qoder在“添加模型”时要求你先选择【提供商】，这个选项直接决定后续填写的字段结构和校验规则。
比如选“阿里云百炼”，系统会自动展开“Region”下拉框和“Model Name”输入框；而选“OpenAI兼容接口”，则只显示“Base URL”和“API Key”两栏——填反了就根本无法保存。
三种可用API格式及填写要点
方法一：OpenAI 兼容格式（适用于百炼、硅基流动、Ollama本地部署等）
Base URL 填完整地址，必须以 https:// 开头，结尾不能带 /v1，例如：https://dashscope.aliyuncs.com/api/v1。Qoder内部会自动拼接 /chat/completions 路径，多加一个 /v1 反而触发404。
API Key 必须是服务商后台生成的长期密钥，不是临时token或session key。百炼平台里叫“API Key”，不是“AccessKey ID/Secret”。
方法二：阿里云百炼原生格式（推荐用于DeepSeek-V4、Qwen3等百炼托管模型）
Provider 选“阿里云百炼” → Region 选“cn-beijing”或“cn-shanghai”（必须与控制台创建API Key时选的区域一致）→ Model Name 填官方命名，如 deepseek-v4、qwen3-32b，【大小写和连字符必须完全匹配百炼文档】。
API Key 粘贴时不要前后带空格，Qoder不会自动trim。复制后建议在记事本里粘贴一次再复制，避免隐藏字符导致验证失败。
方法三：MCP 协议格式（仅限已部署MCP Server的私有模型服务）
需手动编辑JSON配置，格式为：{"mcpServers":{"my-model":{"command":"python mcp_server.py","args":["--host","0.0.0.0:8080"],"env":{"MODEL_PATH":"/models/qwen3"}}}}。其中 command 必须指向可执行文件，不能是shell别名或相对路径；args 中的 host 必须是 0.0.0.0 或具体内网IP，localhost 会被Qoder拒绝连接。
MCP服务启动后，必须能通过 curl http://127.0.0.1:8080/health 返回 {"status":"ok"}，否则Qoder添加时会报“Server unreachable”。
验证API格式是否生效
第一步：在Qoder设置页点击“添加模型”→选择对应Provider→填完所有字段→点击“测试连接”。
第二步：观察右下角弹窗提示——若显示“✅ 连接成功，模型支持chat completion”，说明格式和密钥全部正确；若提示“❌ 认证失败”或“❌ 模型未启用”，请立即返回检查Provider与Model Name是否匹配、API Key是否过期、Region是否填错。
第三步：测试通过后，回到对话窗口，点击模型切换按钮→选择刚添加的模型→发送“你好”测试实际响应。这一步必须做，因为“测试连接”只校验鉴权，不校验模型推理能力。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
