入门文档（docs）
指南（Guides)
错误代码(Error Codes)

错误代码Error codes

本指南包含关于您可能从API和我们的官方Python库中看到的错误代码的概述。

概述中提到的每个错误代码都有一个专门的部分，提供进一步的指导。

API错误API errors

Code概述
401 - Invalid Authentication原因： 非法的身份验证 解决方案： 确保使用了正确的 API key (opens in a new tab) 和请求组织。
401 - Incorrect API key provided原因： 请求API key不正确。 解决方案： 确保使用的API key正确、清除浏览器缓存或生成新的API key (opens in a new tab)。
401 - You must be a member of an organization to use the API原因： 您的帐户不属于任何组织。 解决方案： 联系我们，以加入新组织或要求组织管理员邀请您加入组织 (opens in a new tab)。
429 - Rate limit reached for requests原因： 请求速率太快。 解决方案： 控制请求速率。请阅读速率限制指南。
429 - You exceeded your current quota, please check your plan and billing details原因： 您已达到最大月度支出（硬限制），可以在帐户计费部分 (opens in a new tab)查看。 解决方案： 申请配额增加。
429 - The engine is currently overloaded, please try again later原因： 我们的服务器流量过高。 解决方案： 请稍等片刻后重新尝试您的请求。
500 - The server had an error while processing your request原因： 我们的服务器出现问题。 解决方案： 请稍等片刻后重新尝试您的请求，如果问题仍然存在，请联系我们。检查状态页面 (opens in a new tab)。

401 - Invalid Authentication此错误消息指示您的身份验证凭据无效，这可能由于多种原因导致，例如：

  • API密钥错误或不存在。
  • OpenAI帐户未激活。
  • 未向OpenAI提供所需的身份验证凭据。

401 - Incorrect API key provided 如果您使用的API key不正确，会收到此错误消息。 可能的原因是：

  • API密钥错误。
  • 在API中使用了错误的请求组织。
  • 浏览器缓存中存储了旧的API key。

401 - You must be a member of an organization to use the API 如果您的OpenAI帐户尚未加入组织，则会收到此错误消息。 您也可以为个人使用OpenAI API，但需要先加入组织。 若要加入组织，请联系OpenAI支持人员。

429 - Rate limit reached for requests 如果您发送请求过于频繁，将收到此错误消息。 请遵循速率限制指南中的建议，并控制您的API使用。

429 - You exceeded your current quota, please check your plan and billing details 如果您已达到最大月度支出（硬限制），将收到此错误消息。 您可以在帐户计费部分 (opens in a new tab)查看当前配额限制和使用情况。

429 - The engine is currently overloaded, please try again later 如果服务器流量过高，会出现此错误消息。 等待一会儿后，稍后再次尝试发送API请求。

500 - The server had an error while processing your request 如果您发送API请求时，OpenAI服务器发生问题，将会出现此错误消息。 请稍后再次尝试发送API请求，并联系OpenAI支持人员以报告问题。 您还可以检查OpenAI的状态页面以获取更多信息。

401 - Invalid Authentication此错误消息表示您的身份验证凭据无效，这可能由多种原因导致，例如：

  • 您正在使用已被撤销的API密钥。
  • 您正在使用与请求组织分配的API密钥不同的API密钥。
  • 您正在使用一个不具备调用端点(Completion)所需权限的API密钥。

如果遇到此错误，请按照以下步骤进行处理：

401 - Incorrect API key provided （错误的API密钥）

此错误消息表示您在请求中使用的API密钥不正确，可能是以下几个原因导致：

  • API密钥错误。
  • 在API中使用了不正确的请求组织。
  • 浏览器缓存中存储了旧API密钥。

要解决此错误，请按照以下步骤操作：

要解决此错误，请按照以下步骤操作：

错误代码401 - You must be a member of an organization to use the API

此错误消息表示您的帐户不属于组织。 这可能由多种原因引起，例如：

  • 您已经离开或已从之前的组织中删除。
  • 您所在的组织已被删除。

如果遇到此错误，请按照以下步骤操作：

  • 如果您已经离开或已从之前的组织中删除，则可以请求新的组织或受邀加入现有组织。
  • 要请求新组织，请通过help.openai.com与我们联系。
  • 现有组织的所有者可以通过团队成员 (opens in a new tab)邀请您加入他们的组织。

错误代码429 - Rate limit reached for requests

此错误消息表示您已达到API分配的速率限制。 这意味着您在短时间内提交了过多的令牌或请求，并超过了允许的请求数量。 这可能由多种原因引起，例如：

  • 您正在使用一个需要频繁或并发请求的循环或脚本。
  • 您正在与其他用户或应用程序共享您的API密钥。
  • 您正在使用一个限制较低的免费计划。

为了解决这个错误，请按照以下步骤进行：

  • 控制请求的频率，避免不必要或冗余的调用。

  • 如果您正在使用循环或脚本，请确保实现一个退避机制或重试逻辑来尊重速率限制和响应头。您可以在我们的速率限制指南中阅读有关我们的速率限制策略和最佳实践。

  • 如果您正在与其他用户共享您的组织，请注意限制是针对组织而不是针对用户的。值得检查其余团队的使用情况，因为这将导致限制。

  • 如果您正在使用免费或低端套餐，请考虑升级到按使用量计费的套餐，该套餐提供更高的速率限制。您可以在我们的速率限制指南中比较每个套餐的限制。

错误代码429 - You exceeded your current quota, please check your plan and billing details

此错误消息表示您已达到API的最大月度支出。 您可以在帐户账单设置 (opens in a new tab)中查看您的最大月度限制，即“硬限制”。 这意味着您已消耗掉为您的计划分配的所有信用额度，并已达到当前计费周期的限制。 这可能由于多种原因引起，例如：

  • 您正在使用一个消耗大量积分或令牌的高销量或复杂服务。
  • 您的限制对于您组织的使用来说过低了。

要解决此错误，请按照以下步骤操作：

  • 检查您在帐户设置 (opens in a new tab)中的当前配额。 您可以在“使用情况”部分查看您请求消耗了多少个令牌。
  • 如果您正在使用免费计划，请考虑升级到按使用量计费的计划，以获得更高的配额。
  • 如果需要增加配额，请申请增加并提供有关预计用途的相关详细信息。 我们将审核您的请求，并在约7-10个工作日内作出回应。

错误代码429 - The engine is currently overloaded, please try again later

此错误消息表示我们的服务器正在经历高流量，并且目前无法处理您的请求。 这可能由多种原因引起，例如：

  • 我们的服务需求突然激增。
  • 我们的服务器上安排或未安排的维护或更新。
  • 我们的服务器出现意外或不可避免的停机或事件。

要解决此错误，请按照以下步骤操作：

  • 稍等片刻后再次尝试请求。我们建议使用指数回退策略或重试逻辑，尊重响应标头和速率限制。您可以阅读有关我们速率限制的最佳实践 (opens in a new tab)。
  • 查看我们的状态页面 (opens in a new tab)，查看有关我们的服务和服务器的任何更新或公告。
  • 如果您在合理的时间内仍然遇到此错误，请联系我们寻求进一步帮助。我们为任何不便表示歉意，感谢您的耐心和理解。

Python错误类型 Python library error types

类型概述
APIError原因： 我们方面出现了问题。解决方案： 稍等一会儿后重试请求，如果问题仍然存在，请联系我们。
Timeout原因： 请求超时。 解决方案： 稍等一会儿后重试请求，如果问题仍然存在，请联系我们。
RateLimitError原因： 您已达到分配的速率限制。 解决方案： 缓慢请求。 在我们的速率限制指南中阅读更多。
APIConnectionError原因： 连接到我们服务时出现问题。解决方案： 检查您的网络设置，代理配置，SSL证书或防火墙规则。
InvalidRequestError原因： 请求格式不正确或某些必需的参数（例如令牌或输入）丢失。 解决方案： 错误消息应为您提供有关所犯的具体错误的建议。检查您正在调用的特定API方法的文档 (opens in a new tab)，并确保您发送有效和完整的参数。 您还可能需要检查请求数据的编码，格式或大小。
AuthenticationError原因： 您的API密钥或令牌无效，已过期或已撤销。 解决方案： 检查您的API密钥或令牌，并确保其正确和有效。 您可能需要从帐户仪表板生成新的API密钥和令牌。
ServiceUnavailableError原因： 我们的服务器出现问题。 解决方案： 稍等一会儿后重试请求，如果问题仍然存在，请联系我们。查看状态页面 (opens in a new tab)。

API Error

APIError表示在处理请求时我们的服务端出现问题。这可能是由于临时错误，错误或系统停机引起的。我们为任何不便向您道歉，并努力尽快解决任何问题。您可以查看我们的系统状态页面 (opens in a new tab)获取更多信息。

如果遇到APIError错误，请尝试以下步骤：

  • 等待几秒钟，然后重新尝试您的请求。有时，问题可能会很快得到解决，您的请求可能在第二次尝试中成功。
  • 检查我们的状态页面，了解可能影响我们服务的任何正在进行的事件或维护。如果有活动事件，请跟随更新并等待其解决后再重试您的请求。
  • 如果问题仍然存在，请查看我们的持久错误下一步部分。

我们的支持团队将调查该问题，并尽快回复您。请注意，由于需求量较高，我们的支持队列时间可能很长。您还可以在我们的社区论坛中发布 (opens in a new tab)，但请确保省略任何敏感信息。

Timeout错误

超时（Timeout）错误表示您的请求处理时间过长，我们的服务器已关闭连接。这可能是由于网络问题、我们服务的负载过重或需要更多处理时间的复杂请求造成的。如果出现Timeout错误，请尝试以下步骤：

  • 等待几秒钟，然后重新尝试您的请求。有时，网络拥塞或我们服务的负载可能会减少，您的请求可能会在第二次尝试中成功。
  • 检查您的网络设置，并确保您拥有稳定快速的互联网连接。您可能需要切换到另一个网络，使用有线连接，或减少使用您带宽的设备或应用程序的数量。
  • 如果问题仍然存在，请查看我们持久错误下一步部分。

速率限制错误 （RateLimitError）

速率限制错误（RateLimitError）表示您已经超过被分配的速率限制。这意味着您在给定的时间段内发送了过多的令牌或请求，我们的服务一时阻止您继续发送。为确保对资源的公平和有效利用以及防止滥用或过载我们的服务，我们会实行速率限制。

如果遇到RateLimitError错误，请尝试以下步骤:

  • 发送更少的令牌或请求或降低速度。您可能需要减少请求的频率或数量、批量处理您的令牌或实施指数退避。您可以阅读我们的速率限制指南了解更多详情。
  • 等待速率限制重置（1分钟）并重试您的请求。错误消息应该会让您对您的使用率和允许使用给出一个感觉。
  • 您还可以从您的帐户仪表盘检查您的API使用统计数据。

API连接错误 （APIConnectionError）

API连接错误（APIConnectionError）表示您的请求未能到达我们的服务器或建立安全连接。这可能是由于网络问题、代理配置、SSL证书或防火墙规则引起的。如果您遇到APIConnectionError错误，请尝试以下步骤:

  • 检查您的网络设置并确保您拥有稳定和快速的互联网连接。您可能需要切换到不同的网络、使用有线连接或减少使用带宽的设备或应用程序的数量。
  • 检查您的代理配置并确保其兼容我们的服务。您可能需要更新代理设置、使用不同的代理或完全跳过代理。
  • 检查您的SSL证书并确保其有效并及时更新。您可能需要安装或更新证书、使用不同的证书颁发机构或禁用SSL验证。
  • 检查您的防火墙规则并确保其未阻止或过滤我们的服务。您可能需要修改防火墙设置。
  • 如果适用，请检查您的容器是否具有正确的发送和接收流量的权限。
  • 如果问题仍然存在，请查看我们持久性错误的下一步。

无效请求错误 （InvalidRequestError）

无效请求错误（InvalidRequestError）表示您的请求格式不正确或缺少某些必需的参数，例如令牌或输入。这可能是由于代码中的拼写错误、格式错误或逻辑错误引起的。

如果遇到InvalidRequestError错误，请尝试以下步骤:

  • 仔细阅读错误消息并确定具体的错误。错误消息应该会提醒您缺少或无效的参数，以及期望的值或格式。
  • 检查API参考文档 (opens in a new tab)，查看你正在调用的具体API方法，并确保您发送的参数有效且完整。您可能需要查看参数名称、类型、值和格式，并确保它们与文档匹配。
  • 检查您的请求数据的编码、格式或大小，并确保它们与我们的服务兼容。您可能需要将数据编码为UTF-8，在JSON中格式化您的数据，或压缩数据（如果数据太大）。
  • 使用Postman或curl等工具测试您的请求，并确保它按预期工作。您可能需要调试代码并修复请求逻辑中的任何错误或不一致之处。
  • 如果问题仍然存在，请查看我们的持久性错误下一步操作部分。

身份验证错误（AuthenticationError）

身份验证错误（AuthenticationError）表示您的API密钥或令牌无效、过期或被撤销。这可能是由于代码中的拼写错误、格式错误或安全漏洞引起的。如果遇到AuthenticationError错误，请尝试以下步骤：

  • 检查您的API密钥或令牌，并确保其准确且有效。您可能需要从API密钥仪表板生成新密钥、确保没有额外的空格或字符，或使用不同的密钥或令牌（如果您有多个密钥或令牌）。
  • 确保您的操作格式正确。

服务不可用错误（ServiceUnavailableError）

服务不可用错误（ServiceUnavailableError）表示我们的服务器暂时无法处理您的请求。这可能是由于计划或非计划维护、系统升级或服务器故障引起的。这些错误也可能在高流量期间返回。

我们对任何不便深表歉意，并正在努力尽快恢复我们的服务。

如果遇到ServiceUnavailableError错误，请尝试以下步骤：

  • 等待几分钟，然后重试您的请求。有时，问题可能会迅速解决，并且您的请求可能会在下一次尝试中成功。
  • 查看我们的状态页面 (opens in a new tab)，了解可能影响我们服务的任何正在进行的事故或维护。如果存在活动事件，请关注更新，并等待其解决后再重试您的请求。
  • 如果问题仍然存在，请查看我们的持续错误下一步部分。

如果问题仍然存在 Persistent errors

如果问题仍然存在，请通过聊天联系我们的支持团队 (opens in a new tab)并提供以下信息：

  • 您使用的模型
  • 您收到的错误消息和代码
  • 您发送的请求数据和标头
  • 您的请求的时间戳和时区
  • 任何其他可能有助于我们诊断问题的相关细节

我们的支持团队将调查该问题，并尽快回复您。请注意，由于高需求，我们的支持队列时间可能会很长。您还可以在我们的社区论坛上发布 (opens in a new tab)，但请务必省略任何敏感信息。

处理错误Handling errors

我们建议您以编程方式处理API返回的错误。为此，您可能需要使用以下代码片段之类的代码：

try:
 #Make your OpenAI API request here
 response = openai.Completion.create(prompt="Hello world",
 model="text-davinci-003")
except openai.error.APIError as e:
 #Handle API error here, e.g. retry or log
 print(f"OpenAI API returned an API Error: {e}")
 pass
except openai.error.APIConnectionError as e:
 #Handle connection error here
 print(f"Failed to connect to OpenAI API: {e}")
 pass
except openai.error.RateLimitError as e:
 #Handle rate limit error (we recommend using exponential backoff)
 print(f"OpenAI API request exceeded rate limit: {e}")
 pass
速率限制(Rate Limits)安全最佳实践(Safety Best Practices)