硅基流动报错401\/429如何解决？常见错误代码排查指南

401错误因API Key无效或缺失，需检查空格、格式及重启服务；429错误由速率限制触发，应核对配额、启用指数退避、拆分并发请求；Base URL必须严格为https://api.siliconflow.cn/v1。

硅基流动API调用时突然返回401或429错误，导致模型请求中断、任务卡死、日志里反复刷出状态码报错——这不是网络抖动，而是身份凭证失效或流量策略触发的明确拦截信号。

401 Unauthorized：API Key无效或缺失

第一步：复制API Key时是否漏掉首尾空格或换行符？【必须在硅基流动控制台「API密钥」页点击「复制」按钮，不可手动选中粘贴】

第二步：检查openclaw.json或环境变量中配置的apiKey字段值，确认开头是sk-且长度不少于32位；若用Dify插件，需进入「插件配置→高级设置」展开原始JSON编辑框核对。

第三步：重启服务进程。openclaw需执行openclaw gateway restart；Dify需在后台点击「重新加载插件」；自写Python脚本则必须重建requests.Session实例——旧会话缓存的Header不会自动更新Key。

429 Too Many Requests：触发速率限制

方法一：立即验证当前配额

登录硅基流动控制台→进入「配额管理」页面，查看所用模型的RPM（每分钟请求数）、TPM（每分钟Token数）实时消耗值。注意：RPM未超但TPM已达上限时，照样返回429。

方法二：强制启用指数退避重试

在OpenClaw配置中添加重试策略块：retry: { maxRetries: 5, initialDelayMs: 1000, maxDelayMs: 60000 }；若为自研客户端，须在捕获429响应后暂停2^重试次数秒（如第3次失败则等待8秒），并加入100–500ms随机抖动。

方法三：拆分高并发请求流

对批量处理任务（如1000条文本摘要），禁止for循环直发；改用队列+限速器，例如每秒最多发3个请求→用time.sleep(0.33)硬控节奏，或引入asyncio.Semaphore(value=3)做协程级节流。

Base URL写错导致404被误判为429/401

检查所有配置项中的baseUrl字段，必须严格等于https://api.siliconflow.cn/v1——少一个字符、多一个斜杠、写成siliconflow.com或siliconcloud.com都会被网关拒绝。

【特别注意：Dify插件配置中若手动拼接了/v1/chat/completions到Base URL后，会导致实际请求路径变成/api.siliconflow.cn/v1/v1/chat/completions，必然404】

用curl快速验证：curl -X POST "https://api.siliconflow.cn/v1/chat/completions" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"Qwen/Qwen3-8B","messages":[{"role":"user","content":"test"}]}'