错误码

本页列出 AIGO 算力服务控制台接口（/v1/compute/…，用于创建 / 管理 API Key、查询用量、管理 GPU 实例）的错误码。

调用推理接口（/chat/completions 等）时的错误由 OpenAI 兼容网关返回，格式与 OpenAI 接口一致。

Key 已暂停或已吊销、模型不在白名单、预算用尽等情况下，请求会被推理网关拒绝，具体的 HTTP 状态与错误内容以网关的实际响应为准。

响应格式

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "…",
    "details": { "topup_url": "/console/wallet" }
  }
}

details 只在部分错误中出现，例如 VALIDATION_FAILED 的 details.field 指出出错的字段，INSUFFICIENT_BALANCE 带有所需金额、缺口与充值入口。

常见错误码

HTTP	代码	含义与处理
401	`UNAUTHENTICATED`	未登录或会话已过期，请重新登录
402	`INSUFFICIENT_BALANCE`	可用余额不足，请充值后重试
403	`ROLE_FORBIDDEN`	当前角色无权执行该操作，见成员角色
403	`STEP_UP_REQUIRED` / `STEP_UP_INVALID`	需要（重新）进行二次验证
403	`CSRF_REJECTED` / `ORIGIN_REJECTED`	请求来源校验失败，请刷新页面后重试
404	`NOT_FOUND`	对象不存在或不属于你的工作空间
409	`LEGAL_VERSION_OUTDATED`	条款已更新，请刷新页面重新阅读并同意算力条款与可接受使用政策
409	`KEY_LIMIT_REACHED`	未终结的 Key 数量已达上限，请先吊销不用的 Key
409	`KEY_NOT_SUSPENDED`	只有“已暂停”的 Key 可以恢复
409	`KEY_NOT_REVOCABLE`	该 Key 无法吊销（例如从未开通成功）
409	`KEY_EXPIRED`	Key 已过期，请新建
409	`BUDGET_EXHAUSTED`	总预算已用满，不能恢复，请新建 Key
409	`ARREARS_OUTSTANDING`	存在未结清的欠费，暂不能恢复
409	`PRICE_WITHDRAWN`	价格条件仍未恢复，稍后重试或新建 Key
409	`HOST_INELIGIBLE`	主机未通过可信校验，请新建 Key
409	`IDEMPOTENCY_CONFLICT` / `REQUEST_IN_PROGRESS`	同一请求编号的请求内容不同 / 仍在处理中
409	`LEASE_LIMIT_REACHED`	未结束的 GPU 实例数量已达上限
409	`LEASE_NOT_RUNNING` / `ACCESS_NOT_READY`	实例未在运行，暂无访问入口
409	`CANCEL_UNCONFIRMED` / `CANCEL_UNSAFE`	取消未开始计费的实例尚未确认，请稍后重试或等待平台核验
409	`WIREGUARD_KEY_REJECTED`	WireGuard 公钥无效或重复
413	`BODY_TOO_LARGE`	请求体过大
415	`UNSUPPORTED_MEDIA_TYPE`	请求需使用 `Content-Type: application/json`
422	`VALIDATION_FAILED`	字段校验失败，见 `details.field`
422	`MODEL_UNAVAILABLE` / `OFFER_UNAVAILABLE`	模型或实例规格当前不可售
502	`WALLET_REJECTED` / `GATEWAY_REJECTED` / `PROVISION_FAILED`	下游服务拒绝或开通失败，冻结会释放；请稍后重试或联系支持
503	`WALLET_UNAVAILABLE` / `GATEWAY_UNAVAILABLE` / `INSTANCES_UNAVAILABLE` / `SUPPLY_UNAVAILABLE`	服务暂不可用，请稍后重试
503	`WIREGUARD_CAPACITY_REACHED`	WireGuard 入口容量已满，请稍后重试
500	`INTERNAL_ERROR`	内部错误，请提交工单并说明发生时间与操作