突破私有网关：腾讯 CodeBuddy (TokenHub) 大模型 API 完整调用与接入教程

随着大模型生态的快速更迭，腾讯云在 CodeBuddy 及 TokenHub 聚合网关中上线了大量优质的内置模型。由于该网关（copilot.tencent.com/v2）为了安全与内部逻辑考虑，关闭了标准的 /v2/models 路由，并强制实施了部分前置拦截规则，许多开发者在尝试接入第三方工具（如 LobeChat、Cursor、沉浸式翻译或本地 MCP Agent）时经常会遇到 404 Route Not Found 或 11101 错误。

本文将通过底层接口反馈，为你梳理该网关 100% 验证可用的全量模型 ID 以及标准的接入配置指南。

🛠️ 核心前置条件

在开始配置之前，请确保你已经获取了腾讯 CodeBuddy 的官方鉴权凭证（Token）。

🔒 安全提示：你的 Key 通常以 ck_ 开头。请妥善保管，切勿将其硬编码并上传至 GitHub 等公开平台。在本教程中，我们将统一使用 YOUR_API_KEY 作为占位符。

📊 100% 验证可用的模型 ID 矩阵 (Model IDs)

经过底层接口的自动化盲测与握手校验，该私有网关目前完全放行并支持以下 10 个精确的模型 ID。在配置工具的 "model" 字段时，必须严格填入下表中的字符串：

模型 ID (用于 API 传参)	官方模型名称	说明 / 核心场景
auto	智能路由导航	默认多模混合调度，平衡生成效果与速度
deepseek-v4-pro	DeepSeek-V4-Pro	旗舰推理模型，主攻复杂代码重构与逻辑推演
deepseek-v4-flash	DeepSeek-V4-Flash	旗舰极速模型，适合高频单行代码补全与高吞吐
hy3-preview-agent	腾讯混元 Hy3 Preview	最新思考模型，具备增强的推理与 Agent 编排能力
glm-5.1	智谱 GLM-5.1	全能均衡版，适合日常对话与常规开发任务
glm-5v-turbo	智谱 GLM-5v-Turbo	原生多模态模型，支持视觉/图片输入理解
glm-5.0-turbo	智谱 GLM-5.0-Turbo	针对 Agent 与工具调用（Tool Call）深度优化的版本
kimi-k2.6	Kimi-K2.6	长文本与复杂上下文处理能力强
kimi-k2.5	Kimi-K2.5	多模态平衡版，适合大上下文日常任务
minimax-m2.7	MiniMax-M2.7	能力均衡，适合多语种及高语境理解场景

⚠️ 避坑指南：两大核心网关拦截机制

在接入任何自定义客户端时，必须严格对齐腾讯网关的两条硬性限制，否则会直接请求失败：

1. Base URL 拼接规则 (避免 404 错误)
❌ 错误填法：https://copilot.tencent.com/v2/chat/completions
✅ 正确填法：https://copilot.tencent.com/v2
原因：大多数主流 AI 客户端（如各类 MCP 插件、前端 Proxy）会自动在末尾拼接 /chat/completions。如果填入全路径，发出的请求会变成冗余的双后缀，从而触发网关硬拦截，返回 {"error_msg":"404 Route Not Found"}。
2. 强制流式传输 (避免 11101 错误)
该网关的前置拦截器强制要求所有对话请求必须启用流式传输。在向后端发送 Body 时，必须显式包含 "stream": true，否则后端会直接拒绝请求并提示 "Non-stream chat request is currently not supported"。

💻 命令行快速验证 (PowerShell 7.x)

在接入大型复杂工具前，建议在本地终端（推荐使用 PowerShell 7.x）中跑一条测试命令，快速验证你的 Key 与网关是否连通：

Invoke-RestMethod -Uri "https://copilot.tencent.com/v2/chat/completions" `
  -Method Post `
  -Headers @{
    "Authorization" = "Bearer YOUR_API_KEY"
    "Content-Type"  = "application/json"
  } `
  -Body '{"model": "deepseek-v4-pro", "stream": true, "messages": [{"role": "user", "content": "ping"}]}'

🌐 常见第三方客户端标准配置示例

如果你想将该服务挂载到标准的 OpenAI 兼容客户端（如 LobeChat、NextChat 或自定义 Agent 网关），请参考以下标准 JSON 配置进行映射：

{
  "api_key": "YOUR_API_KEY",
  "base_url": "https://copilot.tencent.com/v2",
  "default_model": "deepseek-v4-pro",
  "custom_models": [
    "auto",
    "hy3-preview-agent",
    "glm-5v-turbo",
    "glm-5.1",
    "glm-5.0-turbo",
    "kimi-k2.6",
    "kimi-k2.5",
    "minimax-m2.7",
    "deepseek-v4-pro",
    "deepseek-v4-flash"
  ]
}

通过以上规范配置，你就可以将腾讯 CodeBuddy 背后庞大的内置模型矩阵无缝转化为本地标准的 AI 生产力工具。如果你在接入过程中遇到了新型的错误代码，欢迎在评论区贴出回显的 JSON 报文进行讨论。

搜索此博客

Free