错误码

错误码

更新于 2026-09-04

本页错误码适用于智能云自有接口（cloud.heimori.cn/v1，sk-heimori- 密钥）。 Tengri 大模型与向量嵌入走 Tengri AI 令牌，错误响应为 OpenAI 风格 { "error": { "message": "...", "type": "..." } }，常见为 401（令牌无效）、 403（配额不足/无权访问模型）、429（限流）、5xx（上游异常），处理方式与 OpenAI API 一致。

所有 /v1 开放接口的错误响应使用统一结构，HTTP 状态码与业务错误码配合定位问题：

json7 行
{
  "error": {
    "code": "invalid_request",
    "message": "text 不能为空",
    "requestId": "req_9f2b1c..."
  }
}
  • code：机器可读的业务错误码（本页表格），建议按 code 而非 message 做程序化处理，message 文案可能调整。
  • message：人类可读的错误说明。
  • requestId：本次请求的追踪 ID，与响应头 X-Request-Id 一致；联系支持时请务必提供。

错误码总表

HTTP 状态码错误码说明处理建议
401invalid_api_keyAPI Key 无效：不存在、格式错误或已被删除检查 Authorization 头是否为 Bearer sk-heimori-... 完整密钥；确认密钥未在控制台删除
401api_key_disabledAPI Key 已被禁用在控制台「API 密钥」页重新启用该密钥，或改用其他可用密钥
401api_key_expiredAPI Key 已过期创建新密钥并更新到调用方配置；建议为密钥设置轮换计划
403scope_not_allowed密钥无权调用该产品（超出 scopes 范围）在控制台调整该密钥的产品范围，或换用具备权限的密钥
403account_suspended云账户已被停用（违规或长期欠费）联系平台支持了解停用原因并申请恢复
403account_banned账号因触发内容安全策略被停用（累计违规或人工封禁）联系平台支持核实处理；解除后自动恢复调用
402insufficient_balance余额不足，已超出允许的欠费下限前往控制台充值后重试；可设置余额告警避免服务中断
429rate_limited触发 QPS 限流降低请求频率；按 Retry-After 响应头或指数退避策略重试
429concurrency_limited并发连接/请求数超限控制并发数量，排队发送；长期不足可申请提升并发上限
429daily_quota_exceeded当日调用量已达日限额次日额度自动恢复；如需更高日限额请在控制台调整密钥配置或联系支持
400invalid_request请求参数不合法（缺参、类型错误、超出取值范围）按响应 message 与 API 参考修正请求参数后重试；重试前请先修正，原样重试不会成功
400unsupported_language语言代码不支持或语向组合不可用检查语言代码拼写；支持的语言与语向以 API 参考为准
413payload_too_large请求体超出大小限制缩减文本长度或压缩文件；大文本请分段、大文档改用任务式接口
404resource_not_found资源不存在（任务 ID、术语库 ID 等无效）检查资源 ID 是否正确、是否属于当前账户
400content_policy_violation输入内容触发内容安全策略，本次调用被拒绝调整输入内容后重试；多次触发将导致账号被停用
502upstream_error上游模型/服务临时异常稍后重试（建议指数退避）；持续失败请携带 requestId 联系支持
500internal_error平台内部错误稍后重试；持续失败请携带 requestId 联系支持

重试建议

  • 可重试：rate_limited、concurrency_limited、upstream_error、internal_error——使用指数退避（如 1s、2s、4s，最多 3~5 次），有 Retry-After 头时按其等待。
  • 修正后重试：invalid_request、unsupported_language、payload_too_large、content_policy_violation——原样重试不会成功，请先修正请求或调整内容。
  • 不应自动重试：invalid_api_key、insufficient_balance、daily_quota_exceeded、account_banned 等——需要人工处理（更换密钥、充值、次日恢复、联系平台）后再调用。