API エラー コードと解決策を調べます。
このガイドでは、APIそして私たちの公式Pythonライブラリ概要に記載されている各エラー コードには、詳細なガイダンスが記載された専用のセクションがあります。
APIエラー
コード | 概要 |
---|---|
401 – 認証が無効です | 原因:無効な認証 解決策:正しい認証方法を確認するAPIキーおよび要求元組織が使用されています。 |
401 – 間違ったAPIキーが指定されました | 原因:要求したAPIキーが正しくありません。 解決策:使用したAPIキーが正しいことを確認するか、ブラウザのキャッシュをクリアするか、新しいものを生成する。 |
401 – API を使用するには組織のメンバーである必要があります | 原因:アカウントが組織に属していません。 解決策:新しい組織に追加してもらうには、弊社までお問い合わせいただくか、組織管理者にご相談ください。組織に招待する。 |
403 – 国、地域、または領土がサポートされていません | 原因:サポートされていない国、地域、または領土からAPIにアクセスしています。解決策 :このページ詳細についてはこちらをご覧ください。 |
429 – リクエストのレート制限に達しました | 原因:リクエストの送信が速すぎます。 解決策:リクエストの送信ペースを調整してください。レート制限ガイド。 |
429 – 現在のクォータを超えました。プランと請求の詳細を確認してください。 | 原因:クレジットが不足しているか、月間利用額の上限に達しています。 解決策: クレジットをさらに購入するまたは方法を学ぶ限界を広げる。 |
500 – リクエストの処理中にサーバーでエラーが発生しました | 原因:サーバー側の問題です。 解決方法:しばらく待ってからリクエストを再試行してください。問題が解決しない場合はお問い合わせください。ステータスページ。 |
503 – エンジンが過負荷状態です。しばらくしてからもう一度お試しください。 | 原因:サーバーのトラフィックが急増しています。 解決策:しばらく待ってからリクエストを再試行してください。 |
503 – スローダウン | 原因:リクエストレートの急激な増加がサービスの信頼性に影響を与えています。 解決策:リクエストレートを元のレベルまで下げ、少なくとも15分間は一定のレートを維持した後、徐々に上げてください。 |
401 – 認証が無効です401 – 間違ったAPIキーが指定されました401 – API を使用するには組織のメンバーである必要があります429 – リクエストのレート制限に達しました429 – 現在のクォータを超えました。プランと請求の詳細を確認してください。503 – エンジンが過負荷状態です。しばらくしてからもう一度お試しください。503 – スローダウン
Pythonライブラリのエラータイプ
タイプ | 概要 |
---|---|
API接続エラー | 原因:サービスへの接続に問題が発生しています。 解決策:ネットワーク設定、プロキシ構成、SSL証明書、またはファイアウォールルールを確認してください。 |
APIタイムアウトエラー | 原因:リクエストがタイムアウトしました。 解決策:少し待ってからリクエストを再試行してください。問題が解決しない場合はお問い合わせください。 |
認証エラー | 原因: APIキーまたはトークンが無効、期限切れ、または失効しています。 解決策: APIキーまたはトークンが正しく有効であることを確認してください。アカウントダッシュボードから新しいキーまたはトークンを生成する必要がある場合があります。 |
不正リクエストエラー | 原因:リクエストの形式が誤っているか、トークンや入力値などの必須パラメータが不足しています。 解決策:エラーメッセージに具体的なエラー内容が記載されています。ドキュメント呼び出しているAPIメソッドごとに、有効かつ完全なパラメータを送信していることを確認してください。リクエストデータのエンコーディング、フォーマット、サイズも確認する必要があるかもしれません。 |
競合エラー | 原因:リソースは別のリクエストによって更新されました。 解決策:リソースを再度更新し、他のリクエストによって更新が試みられていないことを確認してください。 |
内部サーバーエラー | 原因:当社側の問題です。 解決策:しばらく待ってからリクエストを再試行してください。問題が解決しない場合はお問い合わせください。 |
見つかりませんエラー | 原因:要求されたリソースが存在しません。 解決策:正しいリソース識別子であることを確認してください。 |
権限拒否エラー | 原因:要求されたリソースへのアクセス権がありません。 解決策:正しい API キー、組織 ID、リソース ID を使用していることを確認してください。 |
レート制限エラー | 原因:割り当てられたレート制限に達しました。 解決策:リクエストのペースを調整してください。詳しくはレート制限ガイド。 |
処理不可能なエンティティエラー | 原因:形式は正しいものの、リクエストを処理できません。 解決策:リクエストを再度試してください。 |
API接続エラーAPIタイムアウトエラー認証エラー不正リクエストエラー内部サーバーエラーレート制限エラー
永続的なエラー
問題が解決しない場合は、チャットでサポートチームにお問い合わせください以下の情報を提供します。
- 使用していたモデル
- 受け取ったエラーメッセージとコード
- 送信したリクエストデータとヘッダー
- リクエストのタイムスタンプとタイムゾーン
- 問題の診断に役立つ可能性のあるその他の関連詳細
サポートチームが問題を調査し、できるだけ早くご返信いたします。ご依頼が殺到しているため、サポート待ち時間が長くなる場合がございますのでご了承ください。また、コミュニティフォーラムに投稿するただし、機密情報は必ず省略してください。
エラー処理
APIから返されるエラーはプログラムで処理することをお勧めします。そのためには、以下のようなコードスニペットを使用すると便利です。
import openai
from openai import OpenAI
client = OpenAI()
try:
#Make your OpenAI API request here
response = client.chat.completions.create(
prompt="Hello world",
model="gpt-4o-mini"
)
except openai.APIError as e:
#Handle API error here, e.g. retry or log
print(f"OpenAI API returned an API Error: {e}")
pass
except openai.APIConnectionError as e:
#Handle connection error here
print(f"Failed to connect to OpenAI API: {e}")
pass
except openai.RateLimitError as e:
#Handle rate limit error (we recommend using exponential backoff)
print(f"OpenAI API request exceeded rate limit: {e}")
pass