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"}]}'

《夸克》非常好用的免费AI浏览器

下载APP查看