概述
API 账单或配额错误可能表示您已达到获批的使用量限制或配置的支出限制,或者已用完预付额度。更改设置前,请先检查错误。
识别错误
检查 API 响应中的 error.code。账单相关错误仍可能使用含义更宽泛的 error.type 值 insufficient_quota。
| 错误代码 | 含义 | 后续措施 |
| organization_usage_limit_exceeded | 您的组织已达到 OpenAI 为其批准的使用量限制。 | 查看已批准的限制以及提高限制的选项。 |
| organization_spend_limit_exceeded | 您的组织已达到配置的硬性支出限制。 | 查看该组织的支出控制设置。 |
| project_spend_limit_exceeded | 您的项目已达到配置的硬性支出限制。 | 查看该项目的支出控制设置。 |
| credit_balance_exhausted | 您的组织已无剩余预付额度。 | 为 API 余额充值额度。 |
如果不处理相关额度或限制问题,仅重试这些错误无法恢复访问权限。有关详情,请参阅 API 错误代码指南。
查看已批准的使用量限制
前往组织的 限制页面,查看当前获批的每月使用量限制和使用层级。
随着 API 支出增加,OpenAI 会自动将您的组织提升到更高的使用层级。这通常会提高大多数模型的速率限制。请以组织页面显示的限制为准,不要认为每个账户的月度限额都相同。
有关层级详情,请参阅 API 速率限制指南。
检查配置的支出控制设置
支出提醒只会发送通知,不会阻止 API 流量。当记录的支出达到配置金额时,硬性支出限制可能会阻止受影响的请求。
组织限制和项目限制可能同时适用。组织限制涵盖其项目;项目限制涵盖计费到该项目的流量。这些控制设置独立于 OpenAI 批准的使用量限制。
如果错误由硬性限制引起,而支出需要继续,拥有相关设置管理权限的人员可以提高或移除该限制。否则,该限制会在下一个月度周期重置。更改和限制执行并非即时生效,因此记录的支出可能略高于配置金额。
有关设置和说明,请参阅 API 支出限制指南。
检查预付额度余额
如果预付额度已用完,请前往 API 账单门户,选择页面上显示的 购买额度或充值额度余额来购买更多额度。更新后的余额可能需要几分钟才会显示。
有关设置和充值的指导,请参阅:设置预付费账单。
检查是否为速率限制错误
请求速率限制和 Token 速率限制决定了您使用 API 的速度。它们不同于每月使用量限制、支出控制和预付额度余额。
如果遇到请求或 Token 速率限制错误,请参阅:排查 API 速率限制错误。
如果问题仍然存在
上报问题前
请准备好错误消息和代码、错误发生的时间及所在时区,以及所有相关的请求 ID。请从您分享的屏幕截图或代码中移除敏感信息。
联系 OpenAI 支持团队
如果您的需求超出组织可用的限制、您有特殊使用场景,或者在解决错误原因后问题仍然存在,请使用帮助中心的聊天小组件联系 OpenAI 支持团队。
有关联系方式和需要提供的信息,请参阅:联系支持团队。
