OpenAI API 错误解释

在本文中，我们介绍了主要的OpenAI API错误和 API 生成的错误代码。

错误代码 401 – 身份验证失败

此错误消息表示提供的身份验证凭据无效。多种因素可能导致此问题，例如：

• 使用已撤销的 API 密钥。
• 使用不属于请求组织的 API 密钥。
• 使用缺少访问端点所需权限的 API 密钥。

要纠正此错误，请遵守以下准则：

• 确保在请求标头中使用正确的 API 密钥和组织 ID。您可以在您的帐户设置中找到您的 API 密钥和组织 ID。
• 如果您不确定 API 密钥的有效性，您可以创建一个新密钥。请记住在您的请求中用新的 API 密钥替换旧的 API 密钥，并遵守 OpenAI 的推荐做法。

错误代码 404 – API 访问需要组织成员资格

此错误消息表示您的帐户未与组织关联。多种因素可能导致此问题，例如：

• 从您以前的组织中离开或被移除。
• 删除您的组织。

要纠正此错误，请遵守以下准则：

• 如果您已经离开或被从以前的组织中移除，您可以申请一个新组织或收到加入现有组织的邀请。
• 要申请新组织，请通过 help.openai.com 联系我们
• 当前的组织所有者可以通过成员面板邀请您加入他们的组织。

错误代码 429 – 超出 API 请求速率限制

此错误消息表示您已达到为 API 分配的速率限制，表明您在短时间内提交了过多的令牌或请求，超过了允许的请求数。多种因素可能导致此问题，例如：

• 使用启动频繁或同时请求的循环或脚本。
• 与其他用户或应用程序共享您的 API 密钥。
• 使用具有低速率限制的免费计划。

要纠正此错误，请遵守以下准则：

• 隔开您的请求，避免拨打多余或不必要的电话。
• 如果使用循环或脚本，请确保执行退避机制或重试逻辑，以遵守速率限制和响应标头。您可以在此处详细了解我们的速率限制政策和最佳实践。
• 请注意，如果您与其他用户共享您的组织，则限制适用于每个组织而不是每个用户。检查团队其他成员的使用情况是有益的，因为它会影响此限制。
• 如果使用免费或低级别计划，请考虑升级到提供更高速率限制的现收现付计划。

错误代码 429 – 超出每月配额：审查计划和账单明细

此错误消息表示您已达到 API 的每月最大支出（硬性限制）。这意味着您已经用完分配给您的计划的所有积分或单位并达到计费周期的限制。多种因素可能导致此问题，例如：

• 使用每个请求消耗大量信用或单位的大容量或复杂服务。
• 使用需要大量处理请求的大型或多样化数据集。
• 为您的组织的使用设置过低的限制。

要纠正此错误，请遵守以下准则：

• 在您的帐户设置中查看您当前的配额。您可以检查请求的令牌消耗。
• 如果使用免费计划，请考虑升级到提供更高配额的现收现付计划。
• 申请增加配额。OpenAI 将评估您的请求并尽快回复。

错误代码 429 – 引擎过载：请稍后重试

此错误消息表示我们的服务器当前面临高流量，此时无法处理您的请求。多种因素可能导致此问题，例如：

• 对我们服务的需求突然飙升或激增。
• 在我们的服务器上进行的计划内或计划外维护或更新。
• 影响我们服务器的意外或不可避免的中断或事件。

要纠正此错误，请遵守以下准则：

• 在短暂的暂停后再次尝试您的请求。OpenAI 建议采用指数退避策略或尊重响应标头和速率限制的重试逻辑。您可以在此处了解有关 OpenAI 最佳实践的更多信息。
• 监视与 OpenAI 的服务和服务器相关的更新或公告的状态页面。
• 如果此错误在合理的时间后仍然存在，请联系 OpenAI 支持团队。

错误代码 500 – 请求处理期间遇到服务器错误

稍等片刻，然后再次尝试您的请求，如果问题仍然存在，请与我们联系。请查阅状态页面以获取更多信息。