频繁收到429状态码时，应依次采取三步措施：一、申请临时QPS提额，适用于短期高峰；二、实施多API Key负载均衡，提升整体吞吐；三、启用动态路由降级策略，自动切换至高配额备用模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy调用模型时频繁收到429状态码，表明当前API Key的每秒请求数（QPS）已达到平台设定的上限。以下是解决此问题的步骤：
一、申请临时QPS提额
该方法适用于短期业务高峰（如大促、发布会、批量数据处理等），由平台人工审核后为指定API Key临时提升配额，不改变订阅等级，且不影响其他密钥的限流策略。
1、登录WorkBuddy开发者控制台，进入「账户中心 > API密钥管理」页面。
2、找到目标API Key，点击右侧「申请临时提额」按钮，系统自动跳转至提额工单表单页。
3、在表单中填写以下必填项：近24小时监控截图中体现的最高瞬时QPS值；申请提额至的具体QPS数值（须介于当前值与所购Plan上限之间）；明确起止时间（最长不超过72小时）及对应业务场景说明。
4、上传包含时间戳与请求量曲线的Prometheus或WorkBuddy内置监控导出文件（.csv格式）。
5、提交后，WorkBuddy运营团队将在2小时内完成初审，并通过站内信推送审批结果；若通过，新阈值将在5分钟内全节点生效。
二、实施多API Key负载均衡
该方法通过将请求分散至多个已认证的API Key，在不突破单Key限额的前提下提升整体吞吐能力，适用于已启用团队协作或具备子账号管理体系的组织用户。
1、在控制台「团队管理 > 成员列表」中，为需参与分流的成员分配「开发员」或「管理员」角色，并确保其账户已完成实名认证与双因素验证。
2、各成员登录后，进入「个人设置 > API密钥 > 创建新密钥」，生成独立Access Token，并在备注栏标注用途（如“客服对话-主通道”、“内容审核-备用通道”）。
WorkBuddy 会议助手——会议价值不该散会就流失。它把会议的采集、提炼、确认、分发串成一条流水线：从腾讯会议 / IMA / 企业微信多端取料，按 15 类场景模板自动提炼成结构化纪要，你过目确认后一键分发到钉钉、飞书、腾讯文档或企业微信。全程由 workflow 工作流编排驱动，只抽取不编造、先预览后推群、自动去重。 触发：「把会议纪要做一下发钉钉」「总结 IMA 里的 XX 录音」「按面试模板整理这场会」「把这场复盘发飞书」「发到腾讯文档让我手动改」「整理企业微信里的会议纪要」。 能力：腾讯
3、在客户端代码中实现轮询调度逻辑：维护一个包含全部有效Key的数组，每次请求前按索引取下一个Key，索引到达末尾后归零；同时记录每个Key最近一次返回429的时间戳。
4、加入失败熔断机制：若某Key连续3次在10秒内返回429，则自动将其从轮询池中剔除60秒，并触发告警日志记录。
5、配置统一请求头X-WorkBuddy-Route-ID，值为当前选用Key的哈希前缀（如key_abc123… → abc123），便于后端审计与流量归因。
三、启用动态路由降级策略
该方法结合WorkBuddy支持的异构模型能力，在QPS触顶时自动将请求切换至配额更宽松的备用模型，保障任务基本可用性，避免完全阻塞。
1、在模型配置中心为每个启用模型设置独立QPS阈值标签：例如Hunyuan-V3（8 QPS）、DeepSeek-R1（12 QPS）、GLM-4-Flash（15 QPS）。
2、在发起请求前，向请求体注入字段："fallback_enabled": true，并在Header中添加X-Model-Fallback-Policy: "strict"或"loose"。
3、当主模型响应返回429且Header中含X-RateLimit-Remaining: 0时，客户端立即读取预设降级链表，选取下一个QPS更高的模型名称。
4、仅替换请求体中的model字段值，其余参数（messages、temperature、top_p等）保持原样，重新构造并发出请求。
5、每次降级操作需写入本地日志，包含原始模型、目标模型、触发时间、响应延迟差值，以及是否命中缓存加速路径标识。
