错误码

错误与限流速查。平台存在多套错误形态，按调用入口选用下表；未列出的码以接口返回为准。

入口	常见形态	本页章节
Genesis 模型 API	HTTP 状态 + OpenAI 风格 error 体	Genesis / 模型 API
AI Studio / 平台 HTTP API	业务 code / 消息（moi-core 等）	平台 API
MatrixOne 实例与账号控制台	前端常量码（如 Err…）	实例与账号（摘录）

鉴权与调用入口见开发者指南、指南 · Genesis。

---

Genesis / 模型 API

认证

只认：

Authorization: Bearer <API_KEY>

X-API-Key、UC Control Key、浏览器 Cookie 等不能替代。Key 形态常见 sk-gsa-v1-...（以签发结果为准）。

HTTP 状态与处理

状态码	含义	是否重试	处理建议
400	请求参数错误	否	检查字段与取值
401	认证失败	否	Key、是否禁用/过期、请求头
403	无权限 / 模型不在密钥范围	否	改模型或改 Key 可用模型
404	端点或模型不存在	否	Base URL 拼接、model ID
429	限流或额度	是（退避）	降并发、提额、拆 Key
5xx	服务端错误	是（退避）	有限次重试

错误响应骨架（字段以实际为准）：

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Rate limit reached for this API key.",
    "code": "429"
  }
}

限流与额度

层	说明
密钥级速率	并发、RPM、TPM 等
密钥级额度	总额度、日额度（Credit）

对 429 / 5xx 用指数退避 + 抖动；有 Retry-After 时优先遵守。对明确 4xx（除 429）不盲目重试。

现象对照

现象	可能原因	处理
429	速率或额度触顶	退避；看板/密钥提额；拆业务 Key
403 某模型	不在 Key 可用模型	改范围或换模型
认证失败	Key/头错误	仅 Bearer；必要时重签
SDK 报错	base_url / api_key 未指 Genesis	对照「使用」页接入信息
Credit 不足	余额用尽	账户中心
未文档化码	—	以返回为准；附请求上下文反馈支持

---

平台 API

AI Studio / Catalog / 工作区等 HTTP API 的业务错误码由后端 ErrorCode 等枚举定义，随版本扩展。文档侧不维护与源码逐字同步的全量数字表（易过时）。

排障时：

1. 记录响应中的 code / message / request id。

2. 对照操作日志（当前用户请求）。

3. 权限拒绝优先查权限点矩阵与角色配置。

完整枚举以部署中的 moi-core / moi-backend 定义为准。

---

实例与账号（摘录）

MatrixOne Cloud / 实例管理前端常见常量（源：moc-frontend ErrorCode），用于账号、实例登录与告警等界面提示；不是 Genesis Chat 的 HTTP 表。

常量（示意）	含义
ErrJWTVerification / ErrJWTVerifyMissToken	登录态 token 失效或缺失
ErrAccountNotExist / ErrDuplicatedRegister	账号不存在 / 重复注册
ErrLoginInstanceSuspend	实例已挂起
ErrIPHasNoAccess	IP 不在允许范围
ErrLoginDBPlatformFailed	实例账号或密码错误
ErrLoginUserDisabled	用户被禁用
ErrDBConnectionLost	数据库连接断开
ErrDuplicatedInsName	实例重名
ErrProfileStockInsufficient	计算资源库存不足
ErrDuplicatedAlertRule	告警规则重复
ErrExceededMaxAlertRuleCount / ErrExceededMaxContactCount	告警规则/联系人超限
ErrInsufficientFund	余额不足
ErrVoucherCodeIncorrect	代金券激活码错误

实例侧操作见指南 · MatrixOne；工作区告警见监控 · 告警。

---

相关页面

• 开发者指南

• 模型 API

• 系统模型库

• 账户中心