ZZHIMO 智模引擎
API GUIDE

API报错解决：OpenAI API 401、429、余额不足、模型不存在

这是一份面向开发者的 API 错误码中心，帮助你快速判断问题来自 API Key、Base URL、余额、模型名、请求体、限流还是上游服务。

错误码表401 排查Base URL模型不存在429 限流Dify/n8n查看日志
立即注册进入控制台

先看状态码

状态码能快速区分认证、余额、权限、模型名、限流和上游错误。

再看请求日志

控制台日志可以看到模型、状态、消耗和上游返回，避免只凭前端报错猜问题。

最后再改代码

先确认 Base URL、Key、模型名和余额，再调整 SDK 或业务代码。

API 报错快速排查表

遇到报错时，先看 HTTP 状态码，再结合智模引擎控制台里的请求日志判断是 Key、余额、模型名、请求体，还是上游模型限流。

错误常见原因解决方法是否需要联系客服
400请求体 JSON 格式错误、参数缺失、字段类型不正确。检查 model、messages、JSON 引号和逗号。一般不需要
401API Key 错误、请求头格式不对、Key 被禁用或复制了多余空格。使用 Authorization: Bearer YOUR_API_KEY，重新复制控制台 Key。一般不需要
402余额不足、预扣费失败、账户额度不够。充值后重试，或临时切换更低成本模型。视情况
403当前 Key、账号分组或模型权限不足。检查账号状态、分组权限、模型可用范围。可能需要
404模型名错误、接口路径错误，或把 Base URL 和完整接口地址填反。确认模型名、/v1、/chat/completions 的填写位置。一般不需要
408请求超时，输入过长或上游响应过慢。缩短上下文、关闭长输出，客户端超时设置调高。视情况
429请求频率太高、并发过大、上游限流或短时间重复失败。降低并发，使用 1s、3s、5-10s 指数退避重试。视情况
500平台或上游内部异常。稍后重试，查看控制台日志与状态说明。可能需要
502/503/504上游不可用、网关超时、网络波动。切换模型或渠道，降低请求量，必要时联系支持。可能需要

401 Unauthorized：API Key 无效怎么解决

401 是最常见的接入错误，通常不是模型不可用，而是认证信息没有被正确传给接口。

  1. 请求头必须是 Authorization: Bearer YOUR_API_KEY。
  2. 不要把平台登录密码、Telegram 登录信息或用户 ID 当成 API Key。
  3. 重新从控制台复制 Key，确认没有多余空格、换行或中文符号。
  4. 确认 Key 没有被禁用，账号余额和模型权限正常。
curl https://bottoken.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "测试 API 是否正常"}
    ],
    "stream": false
  }'

Base URL 怎么填才正确

大多数 OpenAI SDK、Dify、n8n、Cherry Studio、LobeChat 等工具里，Base URL 应填写：

https://bottoken.cc/v1

如果你是直接请求 Chat Completions，完整请求地址通常是：

https://bottoken.cc/v1/chat/completions
不要把 /chat/completions 填到只要求 Base URL 的位置，也不要只填 https://bottoken.cc 后忘记 /v1。

模型不存在或模型无权限怎么排查

如果返回模型不存在，优先确认你传入的 model 参数和控制台展示的模型名完全一致。不同平台的展示名称、别名和真实请求参数可能不一样。

  1. 检查模型名大小写、横线、点号是否一致。
  2. 确认当前账号分组是否拥有该模型权限。
  3. 确认渠道已启用，并且模型已经同步到模型列表。
  4. 确认该模型支持当前接口，例如 chat/completions、responses 或图片接口。

429 Too Many Requests：限流不等于网站坏了

429 可能来自智模引擎的并发限制，也可能来自上游模型平台。生产环境建议加入重试和降级策略。

不要在 429 后立即无限循环重试，这会进一步放大限流，甚至让业务更慢。

Dify 和 n8n 常见接入报错

Dify 测试连接失败

先检查模型供应商是否选择 OpenAI Compatible，Base URL 是否为 https://bottoken.cc/v1，API Key 是否来自智模引擎控制台，模型名是否可用。完整配置步骤见 Dify 接入 AI API 教程。

n8n HTTP Request 返回 401 或 400

确认 Headers 里有 Authorization 和 Content-Type，Body 选择 JSON，并且没有把表达式写成普通字符串。完整节点配置见 n8n 接入 AI API 教程。

如何在智模引擎控制台查看日志

进入控制台后，可以在使用日志中查看请求时间、模型、状态码、消耗和错误信息。排查时建议同时保留：请求时间、使用的 Key、模型名、错误码、返回信息和对应业务场景。

如果是生产业务，请优先确认是否只有某个模型失败，还是所有模型都失败。单模型失败通常是上游或模型权限问题，全部失败则更可能是 Key、余额、网络或请求格式问题。

相关页面

OpenAI API 接入教程OpenAI Compatible APIAI API 聚合平台API 报错解决Dify 接入 AI APIn8n 接入 AI API

常见问题