先确认错误类型：若返回体含“insufficient_balance”或“402 payment required”，则为余额不足；若为“invalid_api_key”“401”等，则属密钥失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space API调用失败，报错显示余额不足，服务立即中断，Bot无法响应、工作流卡在中间节点、消息发送失败，此时必须快速定位是账户没钱了还是密钥绑错了。
确认错误类型是余额不足而非密钥失效
先看返回体里有没有 【insufficient_balance】 或 【402 Payment Required】 字段。如果出现的是 invalid_api_key、unauthorized 或 401，说明密钥本身已失效，不是余额问题，不用往下查充值路径。
打开Coze Console → 进入「空间设置」→「API管理」，找到当前使用的密钥，检查状态栏是否显示“已启用”。若显示“已撤销”或“过期”，直接跳到更换密钥步骤。
登录Coze控制台查实时余额
这一步不能靠记忆或截图，必须手动刷新验证。很多用户看到邮箱通知“充值成功”，但控制台余额没变，是因为页面缓存未更新。
访问 https://www.php.cn/link/70b0e5c6b6b21693b63b76308e0a2efc → 左侧导航栏点「账户中心」→「余额管理」→ 等待页面加载完成 → 点击右上角「刷新」按钮。
注意：余额数字右侧若带「（处理中）」标签，说明刚充值尚未到账，需等待30秒以上再重试API调用。
三步完成充值并生效
第一步：在「余额管理」页点击「立即充值」按钮。
第二步：选择支付方式——个人用户优先用微信/支付宝扫码；企业用户选「对公转账」，填写开户行与账号后提交工单，财务审核通常需2小时。
第三步：输入金额。系统提示最低充值 ¥50，但实际触发恢复的临界值是 【本次请求预扣费金额 + ¥0.05】，例如报错显示“需¥0.267”，则充¥0.32即可立即生效，无需硬凑¥50。
切换备用密钥或模型降级（临时兜底）
方法一：在Coze控制台「API Keys」页新建一个密钥，复制新key，立刻替换Agent配置中的 api_key 值。旧密钥即使余额为0，新密钥只要绑定账户有余额就能调通。
方法二：修改Agent配置文件，把 model: coze/glm-5.1 改成 model: coze/glm-3-turbo。glm-3-turbo单次调用Token成本约为glm-5.1的38%，适合紧急保活。
注意：降级后输出长度和推理深度会下降，不建议长期使用，仅用于抢修窗口期。
配置余额告警防止再次中断
进入Coze控制台「账户中心」→「通知设置」→ 开启「余额低于阈值时发送邮件」，把阈值设为¥2.00。这个数值能覆盖连续10次中等复杂度Bot调用的费用，留出人工响应时间。
勾选「Webhook通知」，填入你内部运维群的飞书/钉钉机器人地址。告警触发后，系统会自动推送剩余金额与最近一笔扣费明细。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
