常见问题及解决办法
本节汇总接入众扬汇AI开放平台时最常见的报错现象与排查顺序。所有请求的 Base URL 统一为 https://api.allyang.cn，鉴权使用控制台「令牌管理」中创建的令牌（请求头 Authorization: Bearer <令牌>）。
HTTP状态码及其含义
服务端用 HTTP 状态码表达请求结果的类别。下表列出接入过程中最常遇到的几种，便于快速定位：
| 状态代码 | 代码解释 |
|---|---|
| 400 Bad Request | 请求体格式不合法或缺少必填字段，请对照接口文档检查 JSON 结构与参数类型。 |
| 401 Unauthorized | 令牌校验未通过：请确认请求头中的 Authorization: Bearer <令牌> 是否完整、令牌是否已被禁用或删除。 |
| 403 Forbidden | 权限或额度受限：账号余额不足、令牌额度用尽，或当前分组未开通所调用的模型。 |
| 404 Not Found | 请求路径不存在：请核对 Base URL 与接口路径是否拼写正确。 |
| 413 Request Entity Too Large | 请求体过大：请压缩上传内容或拆分请求后重试。 |
| 429 Too Many Requests | 请求过于频繁触发限流：请降低并发或稍后重试（具体限流阈值待补）。 |
| 500 Internal Server Error | 服务端内部异常：请稍后重试，若持续出现请带上响应中的标识信息联系对接人。 |
| 503 Service Unavailable | 服务暂时不可用：多为维护或瞬时过载，请稍后重试。 |
上表仅覆盖常见状态码，并非全集；不同接口的实现可能返回其他状态码，请以响应体中的错误信息为准。