在 ChatGPT 中，由于各种原因（如网络连接不稳定、并发超限、服务器故障等），可能会发生一些错误。ChatGPT 会根据错误类型返回相应的错误代码，以便开发人员进行问题排查和解决。作为二次开发ChatGPT的开发人员，也应该时刻关注和处理系统中出现的错误，以提高用户的体验和满意度。
This guide includes an overview on error codes you might see from both the API and our official Python library. Each error code mentioned in the overview has a dedicated section with further guidance.
本指南包括您可能从API和我们的官方Python库中看到的错误代码的概述。概述中提到的每个错误代码都有一个专门的部分提供进一步的指导。
This error message indicates that your authentication credentials are invalid. This could happen for several reasons, such as:
此错误消息表示您的身份验证凭据无效。这可能有几个原因，例如：
- You are using a revoked API key.
您正在使用已撤销的API密钥。 - You are using a different API key than the one assigned to the requesting organization.
您使用的API密钥与分配给请求组织的API密钥不同。 - You are using an API key that does not have the required permissions for the endpoint you are calling.
您正在使用的API密钥不具有所调用端点所需的权限。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- Check that you are using the correct API key and organization ID in your request header. You can find your API key and organization ID in your account settings.
检查您是否在请求头中使用了正确的API密钥和组织ID。您可以在帐户设置中找到您的API密钥和组织ID。 - If you are unsure whether your API key is valid, you can generate a new one. Make sure to replace your old API key with the new one in your requests and follow our best practices guide.
如果您不确定API密钥是否有效，可以生成一个新密钥。请确保在请求中使用新的API密钥替换旧的API密钥，并遵循我们的最佳实践指南。
This error message indicates that the API key you are using in your request is not correct. This could happen for several reasons, such as:
此错误消息表示您在请求中使用的API密钥不正确。这可能有几个原因，例如：
- There is a typo or an extra space in your API key.
您的API密钥中有拼写错误或多余的空格。 - You are using an API key that belongs to a different organization.
您正在使用属于其他组织的API密钥。 - You are using an API key that has been deleted or deactivated.
您使用的API密钥已被删除或停用。 - An old, revoked API key might be cached locally.
已吊销的旧API密钥可能会在本地缓存。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- Try clearing your browser’s cache and cookies, then try again.
请尝试清除浏览器的缓存和Cookie，然后重试。 - Check that you are using the correct API key in your request header.
检查您在请求头中使用的API密钥是否正确。 - If you are unsure whether your API key is valid, you can generate a new one. Make sure to replace your old API key with the new one in your requests and follow our best practices guide.
如果您不确定API密钥是否有效，可以生成一个新密钥。请确保在请求中使用新的API密钥替换旧的API密钥，并遵循我们的最佳实践指南。
This error message indicates that your account is not part of an organization. This could happen for several reasons, such as:
此错误消息表示您的帐户不属于组织。这可能有几个原因，例如：
- You have left or been removed from your previous organization.
您已离开或被从以前的组织中删除。 - Your organization has been deleted.
您的组织已被删除。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- If you have left or been removed from your previous organization, you can either request a new organization or get invited to an existing one.
如果您已经离开或被从以前的组织中删除，您可以申请新组织或被邀请加入现有组织。 - To request a new organization, reach out to us via help.openai.com
要申请新组织，请通过www.example.com与我们联系help.openai.com - Existing organization owners can invite you to join their organization via the Members Panel.
现有的组织所有者可以通过成员面板邀请您加入他们的组织。
This error message indicates that you have hit your assigned rate limit for the API. This means that you have submitted too many tokens or requests in a short period of time and have exceeded the number of requests allowed. This could happen for several reasons, such as:
此错误消息表示您已达到为API分配的速率限制。这意味着您在短时间内提交了太多令牌或请求，并且超过了允许的请求数量。这可能有几个原因，例如：
- You are using a loop or a script that makes frequent or concurrent requests.
您正在使用一个循环或一个脚本，它会频繁地或并发地发出请求。 - You are sharing your API key with other users or applications.
您正在与其他用户或应用程序共享您的API密钥。 - You are using a free plan that has a low rate limit.
您使用的是速率限制较低的免费计划。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- Pace your requests and avoid making unnecessary or redundant calls.
加快你的请求，避免打不必要或多余的电话。 - If you are using a loop or a script, make sure to implement a backoff mechanism or a retry logic that respects the rate limit and the response headers. You can read more about our rate limiting policy and best practices in our rate limit guide.
如果您使用的是循环或脚本，请确保实现了一个退避机制或重试逻辑，以遵守速率限制和响应头。您可以在我们的速率限制指南中阅读更多关于我们的速率限制政策和最佳实践的信息。 - If you are sharing your organization with other users, note that limits are applied per organization and not per user. It is worth checking on the usage of the rest of your team as this will contribute to the limit.
如果您与其他用户共享您的组织，请注意限制是按组织而不是按用户应用的。值得检查团队其他成员的使用情况，因为这将有助于限制。 - If you are using a free or low-tier plan, consider upgrading to a pay-as-you-go plan that offers a higher rate limit. You can compare the restrictions of each plan in our rate limit guide.
如果您使用的是免费或低层计划，请考虑升级到提供更高速率限制的现收现付计划。您可以在我们的速率限制指南中比较每个计划的限制。
This error message indicates that you have hit your maximum monthly spend for the API. You can view your maximum monthly limit, under ‘hard limit’ in your [account billing settings] (/account/billing/limits). This means that you have consumed all the credits allocated to your plan and have reached the limit of your current billing cycle. This could happen for several reasons, such as:
此错误消息表明您已达到API的每月最大支出。您可以在[帐户计费设置]（/account/billing/limits）中的“硬限制”下查看您的每月最高限额。这意味着您已消耗了分配给计划的所有积分，并已达到当前计费周期的限额。这可能有几个原因，例如：
- You are using a high-volume or complex service that consumes a lot of credits or tokens.
您正在使用消耗大量信用或标记的高容量或复杂服务。 - Your limit is set too low for your organization’s usage.
您的限制设置得太低，不适合您的组织使用。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- Check your current quota in your account settings. You can see how many tokens your requests have consumed in the usage section of your account.
在您的帐户设置中检查您的当前配额。您可以在帐户的使用情况部分查看您的请求已消耗了多少标记。 - If you are using a free plan, consider upgrading to a pay-as-you-go plan that offers a higher quota.
如果您使用的是免费计划，请考虑升级到提供更高配额的现收现付计划。 - If you need a quota increase, you can apply for one and provide relevant details on expected usage. We will review your request and get back to you in ~7-10 business days.
如果您需要增加配额，您可以申请并提供有关预期使用量的相关详细信息。我们将审核您的请求，并在7-10个工作日内回复您。
This error message indicates that our servers are experiencing high traffic and are unable to process your request at the moment. This could happen for several reasons, such as:
此错误消息表示我们的服务器正在经历高流量，目前无法处理您的请求。这可能有几个原因，例如：
- There is a sudden spike or surge in demand for our services.
对我们服务的需求突然激增。 - There is scheduled or unscheduled maintenance or update on our servers.
我们的服务器有定期或不定期的维护或更新。 - There is an unexpected or unavoidable outage or incident on our servers.
我们的服务器发生意外或不可避免的中断或事件。
To resolve this error, please follow these steps:
要解决此错误，请执行以下步骤：
- Retry your request after a brief wait. We recommend using an exponential backoff strategy or a retry logic that respects the response headers and the rate limit. You can read more about our rate limit best practices.
请在短暂等待后重试您的请求。我们建议使用指数回退策略或重试逻辑，以遵守响应报头和速率限制。您可以阅读更多关于我们的费率限制最佳实践。 - Check our status page for any updates or announcements regarding our services and servers.
查看我们的状态页面，了解有关我们的服务和服务器的任何更新或公告。 - If you are still getting this error after a reasonable amount of time, please contact us for further assistance. We apologize for any inconvenience and appreciate your patience and understanding.
如果您在一段合理的时间后仍然收到此错误，请与我们联系以获得进一步帮助。查询不到您需要的页面，给您造成的不便我们深表歉意！
An indicates that something went wrong on our side when processing your request. This could be due to a temporary error, a bug, or a system outage.
“APIError”表示在处理您的请求时，我们这边出现了问题。这可能是由于临时错误、bug或系统中断。
We apologize for any inconvenience and we are working hard to resolve any issues as soon as possible. You can check our system status page for more information.
查询不到您需要的页面，给您造成的不便我们深表歉意！您可以查看我们的系统状态页面了解更多信息。
If you encounter an , please try the following steps:
如果遇到 ，请尝试以下步骤：
- Wait a few seconds and retry your request. Sometimes, the issue may be resolved quickly and your request may succeed on the second attempt.
等待几秒钟，然后重试您的请求。有时，问题可能会很快得到解决，您的请求可能会在第二次尝试时成功。 - Check our status page for any ongoing incidents or maintenance that may affect our services. If there is an active incident, please follow the updates and wait until it is resolved before retrying your request.
查看我们的状态页面，了解可能影响我们服务的任何正在进行的事件或维护。如果存在活动事件，请遵循更新并等待事件解决，然后重试请求。 - If the issue persists, check out our Persistent errors next steps section.
如果问题仍然存在，请查看我们的持续错误后续步骤部分。
Our support team will investigate the issue and get back to you as soon as possible. Note that our support queue times may be long due to high demand. You can also post in our Community Forum but be sure to omit any sensitive information.
我们的支持团队将调查此问题并尽快回复您。请注意，由于需求量大，我们的支持队列时间可能会很长。您也可以在我们的社区论坛发帖，但请务必省略任何敏感信息。
A error indicates that your request took too long to complete and our server closed the connection. This could be due to a network issue, a heavy load on our services, or a complex request that requires more processing time.
“超时”错误表示您的请求花费了太长时间才完成，我们的服务器关闭了连接。这可能是由于网络问题，我们的服务负载过重，或者需要更多处理时间的复杂请求。
If you encounter a Timeout error, please try the following steps:
如果遇到 Timeout 错误，请尝试以下步骤：
- Wait a few seconds and retry your request. Sometimes, the network congestion or the load on our services may be reduced and your request may succeed on the second attempt.
等待几秒钟，然后重试您的请求。有时，网络拥塞或我们服务的负载可能会减少，您的请求可能会在第二次尝试时成功。 - Check your network settings and make sure you have a stable and fast internet connection. You may need to switch to a different network, use a wired connection, or reduce the number of devices or applications using your bandwidth.
检查您的网络设置，并确保您有一个稳定和快速的互联网连接。您可能需要切换到其他网络、使用有线连接或减少使用您的带宽的设备或应用程序的数量。 - If the issue persists, check out our persistent errors next steps section.
如果问题仍然存在，请查看我们的持续错误后续步骤部分。
A indicates that you have hit your assigned rate limit. This means that you have sent too many tokens or requests in a given period of time, and our services have temporarily blocked you from sending more.
表示您已达到指定的速率限制。这意味着您在给定时间内发送了太多标记或请求，我们的服务暂时阻止您发送更多标记或请求。
We impose rate limits to ensure fair and efficient use of our resources and to prevent abuse or overload of our services.
我们实施速率限制，以确保公平和有效地使用我们的资源，并防止滥用或超载我们的服务。
If you encounter a RateLimitError, please try the following steps:
如果遇到 ，请尝试以下步骤：
- Send fewer tokens or requests or slow down. You may need to reduce the frequency or volume of your requests, batch your tokens, or implement exponential backoff. You can read our Rate limit guide for more details.
发送更少的标记或请求或减慢速度。您可能需要减少请求的频率或数量，批量处理标记或实现指数回退。您可以阅读我们的速率限制指南了解更多详情。 - Wait until your rate limit resets (one minute) and retry your request. The error message should give you a sense of your usage rate and permitted usage.
等待您的速率限制重置（一分钟），然后重试您的请求。错误消息应该给予您了解您的使用率和允许的使用情况。 - You can also check your API usage statistics from your account dashboard.
您还可以从帐户仪表板查看API使用统计信息。
An indicates that your request could not reach our servers or establish a secure connection. This could be due to a network issue, a proxy configuration, an SSL certificate, or a firewall rule.
“APIConnectionError”表示您的请求无法到达我们的服务器或建立安全连接。这可能是由于网络问题、代理配置、SSL证书或防火墙规则。
If you encounter an , please try the following steps:
如果遇到 ，请尝试以下步骤：
- Check your network settings and make sure you have a stable and fast internet connection. You may need to switch to a different network, use a wired connection, or reduce the number of devices or applications using your bandwidth.
检查您的网络设置，并确保您有一个稳定和快速的互联网连接。您可能需要切换到其他网络、使用有线连接或减少使用您的带宽的设备或应用程序的数量。 - Check your proxy configuration and make sure it is compatible with our services. You may need to update your proxy settings, use a different proxy, or bypass the proxy altogether.
检查您的代理配置，并确保它与我们的服务兼容。您可能需要更新代理设置、使用其他代理或完全绕过代理。 - Check your SSL certificates and make sure they are valid and up-to-date. You may need to install or renew your certificates, use a different certificate authority, or disable SSL verification.
检查您的SSL证书并确保它们是有效的和最新的。您可能需要安装或续订证书、使用其他证书颁发机构或禁用SSL验证。 - Check your firewall rules and make sure they are not blocking or filtering our services. You may need to modify your firewall settings.
检查您的防火墙规则，确保它们没有阻止或过滤我们的服务。您可能需要修改防火墙设置。 - If appropriate, check that your container has the correct permissions to send and receive traffic.
如果合适，请检查您的容器是否具有发送和接收流量的正确权限。 - If the issue persists, check out our persistent errors next steps section.
如果问题仍然存在，请查看我们的持续错误后续步骤部分。
An indicates that your request was malformed or missing some required parameters, such as a token or an input. This could be due to a typo, a formatting error, or a logic error in your code.
表示您的请求格式不正确或缺少某些必需的参数，例如标记或输入。这可能是由于代码中的打字错误、格式错误或逻辑错误。
If you encounter an , please try the following steps:
如果遇到 ，请尝试以下步骤：
- Read the error message carefully and identify the specific error made. The error message should advise you on what parameter was invalid or missing, and what value or format was expected.
请仔细阅读错误消息并确定所犯的具体错误。错误消息应该告诉您哪个参数无效或丢失，以及需要什么值或格式。 - Check the API Reference for the specific API method you were calling and make sure you are sending valid and complete parameters. You may need to review the parameter names, types, values, and formats, and ensure they match the documentation.
检查API参考以获取您调用的特定API方法，并确保您发送的参数有效且完整。您可能需要检查参数名称、类型、值和格式，并确保它们与文档匹配。 - Check the encoding, format, or size of your request data and make sure they are compatible with our services. You may need to encode your data in UTF-8, format your data in JSON, or compress your data if it is too large.
检查您的请求数据的编码、格式或大小，并确保它们与我们的服务兼容。您可能需要使用UTF-8编码数据，使用JSON格式化数据，或者如果数据太大，则需要压缩数据。 - Test your request using a tool like Postman or curl and make sure it works as expected. You may need to debug your code and fix any errors or inconsistencies in your request logic.
使用Postman或curl等工具测试您的请求，并确保其按预期运行。您可能需要调试代码并修复请求逻辑中的任何错误或不一致。 - If the issue persists, check out our persistent errors next steps section.
如果问题仍然存在，请查看我们的持续错误后续步骤部分。
An indicates that your API key or token was invalid, expired, or revoked. This could be due to a typo, a formatting error, or a security breach.
表示您的API密钥或令牌无效、已过期或已撤销。这可能是由于打字错误、格式错误或安全漏洞造成的。
If you encounter an , please try the following steps:
如果遇到 ，请尝试以下步骤：
- Check your API key or token and make sure it is correct and active. You may need to generate a new key from the API Key dashboard, ensure there are no extra spaces or characters, or use a different key or token if you have multiple ones.
检查您的API密钥或令牌，并确保其正确且处于活动状态。您可能需要从API Key仪表板生成新密钥，确保没有额外的空格或字符，或者如果有多个密钥或令牌，则使用不同的密钥或令牌。 - Ensure that you have followed the correct formatting.
确保您遵循了正确的格式。
A indicates that our servers are temporarily unable to handle your request. This could be due to a planned or unplanned maintenance, a system upgrade, or a server failure. These errors can also be returned during periods of high traffic.
“ServiceUnavailableError”表示我们的服务器暂时无法处理您的请求。这可能是由于计划内或计划外的维护、系统升级或服务器故障。这些错误也可能在高流量期间返回。
We apologize for any inconvenience and we are working hard to restore our services as soon as possible.
查询不到您需要的页面，给您造成的不便我们深表歉意！
If you encounter a , please try the following steps:
如果遇到 ，请尝试以下步骤：
- Wait a few minutes and retry your request. Sometimes, the issue may be resolved quickly and your request may succeed on the next attempt.
请等待几分钟，然后重试您的请求。有时，问题可能会很快得到解决，您的请求可能会在下次尝试时成功。 - Check our status page for any ongoing incidents or maintenance that may affect our services. If there is an active incident, please follow the updates and wait until it is resolved before retrying your request.
查看我们的状态页面，了解可能影响我们服务的任何正在进行的事件或维护。如果存在活动事件，请遵循更新并等待事件解决，然后重试请求。 - If the issue persists, check out our persistent errors next steps section.
如果问题仍然存在，请查看我们的持续错误后续步骤部分。
If the issue persists, contact our support team via chat and provide them with the following information:
如果问题仍然存在，请通过聊天联系我们的支持团队，并向他们提供以下信息：
- The model you were using 你用的模型
- The error message and code you received
您收到的错误消息和代码 - The request data and headers you sent
您发送的请求数据和标头 - The timestamp and timezone of your request
请求的时间戳和时区 - Any other relevant details that may help us diagnose the issue
可能有助于我们诊断问题的任何其他相关详细信息
Our support team will investigate the issue and get back to you as soon as possible. Note that our support queue times may be long due to high demand. You can also post in our Community Forum but be sure to omit any sensitive information.
我们的支持团队将调查此问题并尽快回复您。请注意，由于需求量大，我们的支持队列时间可能会很长。您也可以在我们的社区论坛发帖，但请务必忽略任何敏感信息。
We advise you to programmatically handle errors returned by the API. To do so, you may want to use a code snippet like below:
我们建议您以编程方式处理API返回的错误。要做到这一点，您可能需要使用如下代码段：