最近在折腾 AI 自动化办公工具时我发现了一个很有意思的现象很多朋友把 WorkBuddy 这类工具装好跑通一两个示例就以为万事大吉了。但真到了想把 DeepSeek 这类大模型无缝集成进去实现一些复杂的、定制化的办公流程时问题就来了——要么是 API 调用不通要么是 Token 不够用要么是自定义模型配置起来一头雾水。这背后其实是一个典型的“从玩具到工具”的认知断层。单次跑通一个 Demo和把一个 AI 能力稳定、可靠、低成本地嵌入到你的日常工作流里完全是两回事。今天我们就来聊聊如何利用腾讯云 API 网关这个“中转站”把 DeepSeek 这样的模型变成 WorkBuddy 里一个听话且强大的自定义技能。更重要的是如何在这个过程中巧妙地获取和利用那些免费的 API 调用额度比如传说中的“100万 Token”让自动化办公不再是个烧钱的无底洞。1. 先想清楚为什么需要“自定义模型”这个中间层在 WorkBuddy 里直接填上 DeepSeek 的官方 API Key看起来是最直接的方案。但如果你真的这么试过很快会遇到几个绕不开的坎第一成本与额度管理。DeepSeek 的 API 有免费额度但用完了就得付费。如果你的 WorkBuddy 流程设计得比较复杂或者需要高频调用账单增长会很快。更重要的是你无法在 WorkBuddy 内部精细地控制每个流程、每个用户的用量。第二功能定制与增强。官方 API 提供的是标准能力。但你的办公场景可能需要一些“组合拳”比如在调用模型前先对输入文本进行预处理提取关键信息、格式化在拿到模型输出后再进行后处理解析 JSON、提取特定字段、转换成表格。这些逻辑如果都写在 WorkBuddy 的指令里会变得极其臃肿且难以维护。第三稳定性与降级策略。直接依赖一个外部 API意味着它的任何波动服务降级、响应变慢都会直接影响你的自动化流程。你可能会希望加入重试机制、缓存层或者在主模型不可用时能自动切换到另一个备用的、能力相近但更便宜的模型上。第四安全与审计。将所有请求通过一个受你控制的中间服务转发可以方便地加入日志记录、请求审计、敏感词过滤等安全措施。这对于企业环境或处理敏感信息的自动化流程至关重要。而腾讯云 API 网关恰恰就是为了解决这些问题而生的“中间层”。它不是一个 AI 模型而是一个强大的流量调度、管理和转发平台。你可以把它想象成一个高度可编程的“智能路由器”接收端接收来自 WorkBuddy或其他任何客户端的请求。处理端在这里你可以编写函数比如用云函数 SCF对请求进行任意加工验证 Token、修改参数、合并多个请求、调用其他服务等。转发端将处理后的请求转发给真正的目标服务——比如 DeepSeek 的官方 API 端点。响应端接收 DeepSeek 的返回结果再次进行加工格式化、错误处理最后返回给 WorkBuddy。通过这个架构上面提到的所有问题都有了解决方案。成本控制你可以在 API 网关层设置流控策略限制每分钟/每天的调用次数。功能定制在云函数里写任何预处理/后处理逻辑。稳定性配置重试和备用上游地址。安全审计开启网关的详细访问日志。所以接入“自定义模型”的第一步不是急着去配置参数而是想明白我到底要通过这个中间层解决哪些具体问题是省钱是增强功能还是提升稳定性目标不同后续的架构设计和配置重点也会完全不同。2. 核心资源获取理解“Token”与“免费额度”的玩法几乎所有主流大模型 API 的计费单位都是Token。你可以把它粗略理解为“字数”但更准确地说它是模型用来分割和理解文本的基本单位。一个中文字通常对应 1-2 个 Token一个英文单词可能对应 1 个或更多 Token。当我们谈论“免费领 100 万 Token”时通常指的是某个平台为新用户或完成特定任务提供的API 调用免费额度。这可能是模型提供商直接赠送如 DeepSeek 官方会提供一定量的免费 Token 供测试。云平台作为促销手段例如腾讯云、阿里云等为了推广其 AI 云市场或 API 网关等产品可能会打包赠送合作模型的调用额度。第三方工具集成奖励像 WorkBuddy 这类平台有时会与模型方合作为用户提供兑换码兑换成对应模型的 API 额度。关键点在于这些额度往往绑定的是某个具体的 API Key 或访问凭证而不是直接给你的账户充钱。那么如何找到并利用这些额度呢一个可靠的行动路径如下2.1 第一步确认额度来源与规则不要轻信来路不明的“兑换码”。优先从以下渠道核实DeepSeek 官方平台登录 DeepSeek 开放平台查看个人中心的“余额”或“用量统计”确认官方赠送的免费额度及有效期。腾讯云 AI 相关产品页关注腾讯云“AI 开发平台”、“云市场-AI模型”等板块的活动。有时新用户注册、实名认证、完成新手任务会赠送包含多种模型调用的通用代金券或资源包。WorkBuddy 官方社区或文档查看其公告或教程确认是否有正式的合作伙伴额度发放活动。2.2 第二步获取并保管好 API Key无论额度来自哪里最终都会体现为一组API Key通常包含一个API Key和一个Secret Key或一个Bearer Token。DeepSeek 官方在平台创建应用即可获得。腾讯云如果在腾讯云上调用其集成的或自定义封装的模型需要在“访问管理”中创建密钥对。重要原则这些 Key 如同银行卡密码切勿泄露。不要直接写在客户端代码或 WorkBuddy 的公开配置里。2.3 第三步理解额度的消耗方式假设你获得了 100 万 Token 的免费额度。如何消耗每次调用 API模型处理你的输入Prompt和生成输出Completion所花费的 Token 总数会从额度中扣除。一个简单的估算如果你每次问答平均消耗 1000 Token那么 100 万 Token 大约可以支持 1000 次交互。对于自动化办公中的文本总结、邮件撰写、数据清洗等任务这个额度足够进行深入的学习和测试。监控用量务必定期在发放额度的平台查看用量明细避免在不知情的情况下超额使用产生计划外的费用。2.4 第四步将额度“接入”你的架构这是我们接下来要搭建的核心。我们的目标不是把 DeepSeek 的 API Key 直接填进 WorkBuddy而是将其配置在腾讯云 API 网关的后端服务中。这样WorkBuddy 只需要调用腾讯云 API 网关的地址而真正的 DeepSeek Key 被安全地隐藏在后端。这样做的另一个好处是如果未来 DeepSeek 的免费额度用尽或者你想切换成另一个有额度的模型比如腾讯云内部的某个模型你只需要在 API 网关的后端配置里修改一下转发地址和 KeyWorkBuddy 侧的所有指令和流程都无需任何改动。这实现了调用方WorkBuddy与模型服务方的解耦。3. 实战搭建从腾讯云 API 网关到 WorkBuddy 的完整链路现在我们进入实操环节。请跟随以下步骤目标是创建一个属于你自己的、可被 WorkBuddy 调用的“DeepSeek 自定义模型”。3.1 第一阶段在腾讯云创建 API 网关服务登录腾讯云控制台搜索并进入API 网关产品。创建服务点击“新建服务”。服务名称可以叫workbuddy-ai-proxy类型选择“HTTP”网络类型通常选“公网”。创建 API在刚创建的服务下点击“新建 API”。前端配置路径Path/deepseek/chat你可以自定义这是 WorkBuddy 要调用的地址请求方法POST鉴权类型选择“免鉴权”进行测试后期可改为“密钥对”以提升安全性。后端配置后端类型选择“HTTP”后端域名填写 DeepSeek 的官方 API 端点例如https://api.deepseek.com路径/chat/completions这是 DeepSeek 的聊天补全接口路径请求方法POST关键步骤参数映射与 Header 设置这是核心所在。我们需要将 WorkBuddy 发来的请求原样或加工后转发给 DeepSeek并将 DeepSeek 的响应返回。在“后端配置”中找到参数配置或Header 配置。你需要添加一个Header名为Authorization值设置为Bearer 你的DeepSeek_API_Key。请将你的DeepSeek_API_Key替换成你实际的 Key。确保请求体Body的映射是“透传”的。通常 API 网关默认会将前端请求的 Body 直接转发给后端。发布服务配置完成后将 API 发布到某个“发布环境”例如release或test。发布后你会获得一个访问地址形如https://service-xxxxx-xxx.gz.apigw.tencentcs.com/release/deepseek/chat。这个地址就是 WorkBuddy 未来需要调用的“自定义模型”地址。3.2 第二阶段在云函数中实现逻辑增强可选但推荐如果你需要预处理或后处理上述简单的转发就不够了。这时需要引入云函数 SCF。在 API 网关的“后端配置”中将后端类型改为“云函数”。创建一个新的云函数运行环境选择Python 3.7或Node.js。编写函数逻辑。以下是一个 Python 示例展示了如何转发请求并加入简单的日志和错误处理import json import requests def main_handler(event, context): # 1. 解析 API 网关传递过来的请求 req_body json.loads(event[body]) print(fReceived request: {json.dumps(req_body, ensure_asciiFalse)}) # 2. (可选) 请求预处理例如确保 messages 字段存在 if messages not in req_body: return { statusCode: 400, body: json.dumps({error: Missing messages field}) } # 3. 准备请求 DeepSeek 的 Headers headers { Content-Type: application/json, Authorization: Bearer YOUR_DEEPSEEK_API_KEY_HERE # 务必替换 } # 4. 转发请求到 DeepSeek deepseek_url https://api.deepseek.com/chat/completions try: response requests.post(deepseek_url, headersheaders, jsonreq_body, timeout30) response.raise_for_status() # 检查 HTTP 错误 result response.json() print(fDeepSeek response: {json.dumps(result, ensure_asciiFalse)}) # 5. (可选) 响应后处理例如提取标准格式内容 ai_message result[choices][0][message][content] if result.get(choices) else # 6. 返回给 API 网关 (最终到 WorkBuddy) return { statusCode: 200, body: json.dumps({ original_response: result, extracted_content: ai_message # 提供一个更干净的字段 }) } except requests.exceptions.RequestException as e: print(fError calling DeepSeek: {e}) return { statusCode: 500, body: json.dumps({error: Failed to call AI service, detail: str(e)}) }将这个云函数与 API 网关的 API 关联起来。这样所有流量都会先经过你的云函数由你完全控制再决定如何与 DeepSeek 交互。3.3 第三阶段在 WorkBuddy 中配置自定义模型现在我们回到 WorkBuddy。打开 WorkBuddy 的技能或模型配置页面找到“自定义模型”或“外部 API”的添加入口。模型名称可以命名为“我的 DeepSeek 代理”或“腾讯云-DeepSeek”。API 端点填写你在3.1 第5步获得的腾讯云 API 网关地址。认证信息如果在 API 网关创建 API 时选择了“密钥对”鉴权这里需要填写腾讯云 API 网关的SecretId和SecretKey。如果选择的是“免鉴权”这里可能留空或填写一个固定的 Token具体看 WorkBuddy 的字段要求。请求格式通常选择JSON。请求体Body的格式需要与 DeepSeek API 要求的一致。一个最简化的示例格式如下你可以在 WorkBuddy 的自定义指令或技能配置中以变量的形式动态构建这个 JSON{ model: deepseek-chat, messages: [ {role: user, content: {{用户输入的问题}}} ], stream: false }响应解析告诉 WorkBuddy 如何从返回的 JSON 中提取出文本内容。如果使用简单的网关转发路径可能是choices[0].message.content。如果使用了上述云函数并返回了extracted_content字段则路径可以设为extracted_content。测试连接保存配置后使用 WorkBuddy 提供的测试功能发送一条简单消息看是否能收到正确的 AI 回复。至此一个通过腾讯云 API 网关桥接的、可被 WorkBuddy 调用的自定义 DeepSeek 模型就配置完成了。你的 WorkBuddy 技能现在调用的不再是官方端点而是你完全可控的代理服务。4. 从“跑通”到“用好”关键配置、避坑与高阶思路成功调通只是第一步。要让这个组合在真实的办公自动化中稳定、高效、省钱地运行还需要关注以下几个层面。4.1 安全与成本管控给 API 网关加上“阀门”直接在公网暴露一个转发服务是危险的可能被他人盗刷消耗你的 Token 额度。开启鉴权在 API 网关中将 API 的鉴权类型从“免鉴权”改为“密钥对”。这样只有携带正确SecretId和SecretKey的请求来自你的 WorkBuddy才能调用。设置流量控制在 API 网关中为你的 API 创建“流控策略”。例如限制单个密钥对每分钟最多调用 10 次每天最多 1000 次。这能有效防止意外循环调用或恶意攻击导致的额度爆掉。绑定自定义域名并启用 HTTPS使用自己的域名并配置 SSL 证书让通信更安全、更专业。4.2 稳定性与可观测性知道发生了什么启用日志务必在腾讯云 API 网关控制台和云函数 SCF 控制台开启日志投递功能。所有请求和响应的详情、错误信息都会被记录下来。当 WorkBuddy 流程出错时这是你排查问题的第一现场。设置超时与重试在 API 网关配置中合理设置后端超时时间如 30 秒。对于网络波动导致的偶发失败可以在云函数逻辑中或 WorkBuddy 技能层面加入简单的重试机制。监控告警在腾讯云“云监控”中为 API 网关的请求次数、错误率、响应时间等关键指标设置告警。当服务异常时能第一时间收到通知。4.3 高阶玩法让“自定义模型”更智能单一的模型转发只是开始API 网关云函数的组合能玩出更多花样负载均衡与降级在云函数中可以同时配置多个模型的上游地址如 DeepSeek、GPT、国内其他大模型。根据当前主模型的响应状态、成本或任务类型智能地选择或切换调用目标。当 DeepSeek 服务不稳定时自动切换到备用模型保障流程不中断。上下文管理与记忆WorkBuddy 的单次调用可能是无状态的。你可以在云函数中集成 Redis 等数据库为每个会话Session保存历史对话记录。当新的请求到来时自动将历史记录拼接成完整的上下文再发给模型实现跨指令的连续对话。结果格式化与集成对于办公场景模型返回的可能是自由文本。你可以在云函数中编写后处理逻辑将其自动解析成标准的 JSON 结构、Markdown 表格甚至直接调用腾讯云的其他服务如发送邮件、写入在线文档、生成图表形成一个完整的自动化闭环。4.4 常见错误排查指南如果在配置或使用过程中遇到问题请按以下顺序排查WorkBuddy 侧报错首先检查 WorkBuddy 中配置的 API 端点、认证信息是否完全正确。使用简单的工具如 Postman 或 curl直接测试你的腾讯云 API 网关地址看是否能收到预期响应。API 网关日志查看 API 网关的日志确认请求是否成功到达网关网关转发给后端云函数或 DeepSeek的请求是什么后端返回了什么。常见的 403、404、502 错误在这里都能找到根源。云函数日志如果你使用了云函数这里是查看业务逻辑错误如 Python 代码异常、网络请求超时的最佳位置。DeepSeek 额度与状态确认你的 DeepSeek API Key 有效且额度充足。直接使用该 Key 调用官方接口验证服务是否正常。网络与权限确认云函数或 API 网关所在的云服务网络能够正常访问 DeepSeek 的海外 API 地址如果需要。检查云函数的运行角色是否拥有访问外网的权限。回过头看我们做的远不止是“接入一个模型”。我们实际上是在构建一个属于你自己的、可管控的 AI 能力微服务。腾讯云 API 网关是这个服务的网关和调度中心DeepSeek 是背后的能力提供者之一而 WorkBuddy 则是这个服务的一个优秀消费者。这种架构带来的最大好处是控制力和灵活性。你控制了成本、安全、逻辑和稳定性。未来无论 DeepSeek 的 API 如何变化是否有新的、更划算的模型出现你都可以在后台无缝切换和升级而前端的无数个自动化工作流完全不受影响。这才是将 AI 深度融入办公流程并使之长期、可靠运行的关键所在。