API 錯誤

• 401 - Invalid Authentication

此錯誤消息表明您的身份驗證憑據無效。發(fā)生這種情況的原因可能有多種，例如：

• 您使用的是已撤銷的 API 密鑰。

• 您使用的 API 密鑰與分配給請求組織的 API 密鑰不同。

• 您使用的 API 密鑰沒有您所調用端點所需的權限。

要解決此錯誤，請執(zhí)行以下步驟：

• 檢查您是否在請求標頭中使用了正確的 API 密鑰和組織 ID。您可以在您的帳戶設置中找到您的 API 密鑰和組織 ID。

• 如果您不確定您的 API 密鑰是否有效，您可以生成一個新密鑰。確保在請求中用新的 API 密鑰替換舊的 API 密鑰，并遵循我們的最佳實踐指南。

• 401 - Incorrect API key provided

此錯誤消息表示您在請求中使用的 API 密鑰不正確。發(fā)生這種情況的原因可能有多種，例如：

• 您的 API 密鑰中有拼寫錯誤或多余的空格。

• 您正在使用屬于不同組織的 API 密鑰。

• 您正在使用已被刪除或停用的 API 密鑰。

• 舊的、已撤銷的 API 密鑰可能會緩存在本地。

要解決此錯誤，請執(zhí)行以下步驟：

• 嘗試清除瀏覽器的緩存和 cookie，然后重試。

• 檢查您是否在請求標頭中使用了正確的 API 密鑰。

• 如果您不確定您的 API 密鑰是否正確，您可以生成一個新的。確保替換代碼庫中的舊 API 密鑰并遵循我們的最佳實踐指南。

• 401 - You must be a member of an organization to use the API

此錯誤消息表明您的帳戶不屬于某個組織。發(fā)生這種情況的原因可能有多種，例如：

• 您已經離開或被從以前的組織中移除。

• 您的組織已被刪除。

要解決此錯誤，請執(zhí)行以下步驟：

• 如果您已經離開或被從以前的組織中移除，您可以申請一個新組織或受邀加入現有組織。

• 要申請新組織，請通過 help.openai.com 聯系我們

• 現有組織所有者可以通過成員面板邀請您加入他們的組織。

• 429 - Rate limit reached for requests

此錯誤消息表示您已達到為 API 分配的速率限制。這意味著您在短時間內提交了過多的令牌或請求，并且超出了允許的請求數量。發(fā)生這種情況的原因可能有多種，例如：

• 您正在使用發(fā)出頻繁或并發(fā)請求的循環(huán)或腳本。

• 您正在與其他用戶或應用程序共享您的 API 密鑰。

• 您正在使用具有低速率限制的免費計劃。

要解決此錯誤，請執(zhí)行以下步驟：

• 調整您的請求，避免進行不必要或多余的呼叫。

• 如果您使用的是循環(huán)或腳本，請確保實施退避機制或尊重速率限制和響應標頭的重試邏輯。您可以在我們的速率限制指南中詳細了解我們的速率限制政策和最佳實踐。

• 如果您與其他用戶共享您的組織，請注意限制是按組織而不是按用戶應用的。值得檢查您團隊其他成員的使用情況，因為這會影響限制。

• 如果您使用的是免費或低級別計劃，請考慮升級到提供更高速率限制的現收現付計劃。您可以在我們的速率限制指南中比較每個計劃的限制。

• 429 - You exceeded your current quota, please check your plan and billing details

此錯誤消息表示您已達到 API 的每月最大支出。您可以在 [account billing settings](/account/billing/limits) 的“hard limit”下查看每月最高限額。這意味著您已經消耗了分配給您的計劃的所有積分，并且已經達到了當前賬單周期的限制。發(fā)生這種情況的原因可能有多種，例如：

• 您正在使用消耗大量信用或代幣的大容量或復雜服務。

• 對于您的組織的使用，您的限制設置得太低。

要解決此錯誤，請執(zhí)行以下步驟：

• 在您的帳戶設置中檢查您當前的配額。您可以在帳戶的使用部分查看您的請求消耗了多少令牌。

• 如果您使用的是免費計劃，請考慮升級到提供更高配額的現收現付計劃。

• 如果您需要增加配額，您可以申請一個并提供有關預期使用情況的相關詳細信息。我們將審核您的請求并在大約 7-10 個工作日內回復您。
• 429 - The engine is currently overloaded, please try again later

此錯誤消息表明我們的服務器流量過大，目前無法處理您的請求。發(fā)生這種情況的原因可能有多種，例如：

• 對我們服務的需求突然激增。

• 我們的服務器有計劃或計劃外的維護或更新。

• 我們的服務器發(fā)生意外或不可避免的中斷或事件。

要解決此錯誤，請執(zhí)行以下步驟：

• 稍等片刻后重試您的請求。我們建議使用指數退避策略或尊重響應標頭和速率限制的重試邏輯。您可以閱讀更多關于我們的速率限制最佳實踐的信息。
• 查看我們的狀態(tài)頁面，了解有關我們的服務和服務器的任何更新或公告。

• 如果在合理的時間后您仍然收到此錯誤，請聯系我們以獲得進一步的幫助。對于給您帶來的不便，我們深表歉意，感謝您的耐心等待和理解。

Python 庫錯誤類型

• APIError

`APIError` 表示我們在處理您的請求時出了點問題。這可能是由于臨時錯誤、錯誤或系統(tǒng)中斷造成的。

對于給您帶來的任何不便，我們深表歉意，我們正在努力盡快解決任何問題。您可以查看我們的系統(tǒng)狀態(tài)頁面以獲取更多信息。

如果遇到 APIError，請嘗試以下步驟：

• 等待幾秒鐘，然后重試您的請求。有時，問題可能會很快得到解決，您的請求可能會在第二次嘗試時成功。

• 查看我們的狀態(tài)頁面，了解任何可能影響我們服務的持續(xù)事件或維護。如果有活動事件，請關注更新并等到問題解決后再重試您的請求。

• 如果問題仍然存在，請查看我們的持續(xù)性錯誤后續(xù)步驟部分。

我們的支持團隊將調查此問題并盡快回復您。請注意，由于需求量大，我們的支持排隊時間可能會很長。您也可以在我們的社區(qū)論壇中發(fā)帖，但請務必省略任何敏感信息。

• Timeout

“超時”錯誤表示您的請求完成時間過長，我們的服務器關閉了連接。這可能是由于網絡問題、我們的服務負載過重或需要更多處理時間的復雜請求。

如果遇到超時錯誤，請嘗試以下步驟：

• 等待幾秒鐘，然后重試您的請求。有時，網絡擁塞或我們服務的負載可能會減少，您的請求可能會在第二次嘗試時成功。

• 檢查您的網絡設置并確保您擁有穩(wěn)定快速的互聯網連接。您可能需要切換到不同的網絡、使用有線連接或減少使用帶寬的設備或應用程序的數量。

• 如果問題仍然存在，請查看我們的持續(xù)錯誤后續(xù)步驟部分。

• RateLimitError

`RateLimitError` 表示您已達到指定的速率限制。這意味著您在給定時間段內發(fā)送了過多的令牌或請求，我們的服務已暫時阻止您發(fā)送更多。

我們施加速率限制以確保公平有效地使用我們的資源并防止濫用或超載我們的服務。

如果遇到 RateLimitError，請嘗試以下步驟：

• 發(fā)送更少的令牌或請求或放慢速度。您可能需要減少請求的頻率或數量、批處理令牌或實施指數退避。您可以閱讀我們的速率限制指南了解更多詳情。

• 等到您的速率限制重置（一分鐘）并重試您的請求。錯誤消息應該讓您了解您的使用率和允許的使用情況。

• 您還可以從您的帳戶信息中心查看您的 API 使用統(tǒng)計信息。

• APIConnectionError

`APIConnectionError` 表示您的請求無法到達我們的服務器或無法建立安全連接。這可能是由于網絡問題、代理配置、SSL 證書或防火墻規(guī)則造成的。

如果遇到 APIConnectionError，請嘗試以下步驟：

• 檢查您的網絡設置并確保您擁有穩(wěn)定快速的互聯網連接。您可能需要切換到不同的網絡、使用有線連接或減少使用帶寬的設備或應用程序的數量。

• 檢查您的代理配置并確保它與我們的服務兼容。您可能需要更新代理設置、使用不同的代理或完全繞過代理。

• 檢查您的 SSL 證書并確保它們有效且是最新的。您可能需要安裝或更新證書、使用不同的證書頒發(fā)機構或禁用 SSL 驗證。

• 檢查您的防火墻規(guī)則并確保它們沒有阻止或過濾我們的服務。您可能需要修改防火墻設置。

• 如果合適，請檢查您的容器是否具有發(fā)送和接收流量的正確權限。

• 如果問題仍然存在，請查看我們的持續(xù)錯誤后續(xù)步驟部分。

• InvalidRequestError

InvalidRequestError 表示您的請求格式錯誤或缺少一些必需的參數，例如令牌或輸入。這可能是由于代碼中的拼寫錯誤、格式錯誤或邏輯錯誤。

如果遇到 InvalidRequestError，請嘗試以下步驟：

• 仔細閱讀錯誤消息并確定具體的錯誤。錯誤消息應告知您哪些參數無效或丟失，以及預期的值或格式。

• 查看 API 參考以了解您正在調用的特定 API 方法，并確保您發(fā)送的參數有效且完整。您可能需要查看參數名稱、類型、值和格式，并確保它們與文檔相符。

• 檢查您請求數據的編碼、格式或大小，并確保它們與我們的服務兼容。您可能需要以 UTF-8 編碼您的數據，以 JSON 格式化您的數據，或者如果數據太大則壓縮您的數據。

• 使用 Postman 或 curl 等工具測試您的請求，并確保它按預期工作。您可能需要調試代碼并修復請求邏輯中的任何錯誤或不一致。

• 如果問題仍然存在，請查看我們的持續(xù)錯誤后續(xù)步驟部分。

• AuthenticationError

`AuthenticationError` 表示您的 API 密鑰或令牌無效、過期或已撤銷。這可能是由于拼寫錯誤、格式錯誤或安全漏洞造成的。

如果遇到 AuthenticationError，請嘗試以下步驟：

• 檢查您的 API 密鑰或令牌并確保其正確且有效。您可能需要從 API 密鑰儀表板生成一個新密鑰，確保沒有多余的空格或字符，或者如果您有多個密鑰或令牌，則使用不同的密鑰或令牌。

• 確保您遵循了正確的格式。

• ServiceUnavailableError

`ServiceUnavailableError` 表示我們的服務器暫時無法處理您的請求。這可能是由于計劃內或計劃外維護、系統(tǒng)升級或服務器故障所致。這些錯誤也可以在高流量期間返回。

對于給您帶來的不便，我們深表歉意，我們正在努力盡快恢復我們的服務。

如果遇到 ServiceUnavailableError，請嘗試以下步驟：

• 等待幾分鐘，然后重試您的請求。有時，問題可能會很快得到解決，您的請求可能會在下一次嘗試時成功。

• 查看我們的狀態(tài)頁面，了解任何可能影響我們服務的持續(xù)事件或維護。如果有活動事件，請關注更新并等到問題解決后再重試您的請求。

• 如果問題仍然存在，請查看我們的持續(xù)錯誤后續(xù)步驟部分。

持續(xù)性錯誤

如果問題仍然存在，請通過聊天聯系我們的支持團隊并向他們提供以下信息：

• 您使用的型號

• 您收到的錯誤消息和代碼

• 您發(fā)送的請求數據和標頭

• 您請求的時間戳和時區(qū)

• 任何其他可能有助于我們診斷問題的相關詳細信息

我們的支持團隊將調查此問題并盡快回復您。請注意，由于需求量大，我們的支持排隊時間可能會很長。您也可以在我們的社區(qū)論壇中發(fā)帖，但請務必省略任何敏感信息。

處理錯誤

我們建議您以編程方式處理 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