常见问题 FAQ
401 / 403 / 429 / 503 的含义与自查动作，及高频接入疑问。
遇到报错先别慌：绝大多数问题都能靠下面这几步定位。
报错自查
401 Unauthorized：未认证 / 令牌无效
含义：请求头里的令牌缺失、拼错、已禁用或已撤销。
自查：① 确认 Authorization: Bearer <令牌> 格式正确、无多余空格或换行；② 到「令牌」页确认该令牌处于「启用」且未过期；③ 重新复制一份令牌再试。
403 Forbidden：无权限 / 额度不足
含义：令牌无权调用该模型，或额度/余额已用尽。 自查：① 检查令牌的模型白名单是否包含目标模型；② 到「钱包/账单」看余额、到令牌看剩余额度；③ 若为管理接口返回 403，通常是普通用户越权访问，需管理员权限。
429 Too Many Requests：触发限流
含义：单位时间请求数超过令牌速率限制，或上游供应商限流。 自查：① 降低并发/频率，做指数退避重试；② 如为业务正常高并发，联系管理员上调令牌速率或增加渠道。
503 Service Unavailable：无可用渠道
含义：该模型当前没有「已启用且有额度」的上游渠道可承接请求。 自查：① 换一个已在「模型广场」列出的模型试试；② 若你是管理员，去「渠道」页确认对应渠道已配置密钥、状态为启用且未耗尽；③ 稍后重试（渠道可能被自动禁用后恢复）。 注意：503 是真实的「无上游可用」信号，不会伪造返回。
404 Not Found：模型或路径不存在
含义：model 名拼错，或请求路径不是有效的 /v1/... 端点。
自查：① 用「模型广场」里完全一致的名字；② 确认 Base URL 以 /v1 结尾且端点为 /chat/completions 等合法路径。
高频疑问
Q：Base URL 要不要带 /v1？
A：OpenAI 兼容 SDK 的 base_url 填 https://maas.thinkalike.com.cn/v1。部分框架会自动补 /chat/completions，无需自己再加。
Q：能在 LangChain / Dify / IDE 插件里用吗？ A：只要该工具支持「OpenAI 兼容」接入，填上面的 Base URL 和你的令牌即可。
Q：流式没有逐字输出，像一次性返回？
A：确认请求体里 stream: true，且客户端按 SSE 读取。若经代理，确保未对 /v1 做整体缓冲。
Q：忘了令牌放哪了 / 怀疑泄露？ A：出于安全令牌只在创建时完整显示一次。忘记请新建一个；怀疑泄露立即在「令牌」页撤销旧令牌。见 令牌与配额。
还是解决不了？
- 查「日志」看这次调用的具体错误详情：日志与用量。
- 深入参数与接口契约：完整文档 /doc。
- 平台整体介绍：关于 ThinkMaaS。
本页只覆盖高频场景；所有错误码与响应结构的权威定义，以 /doc 为准。