エラーコード | OpenAI API

このガイドでは、API と公式 Python ライブラリで発生するエラーコードの概要を説明します。概要に記載した各エラーコードの詳細と対処方法は、個別のセクションで解説します。

API のエラー

コード	概要
400 - `service_tier` 引数が無効	原因：リクエストで指定したサービスティア、または自動的に選択されたサービスティアが、プロジェクトで許可されていません。対処方法： `service_tier` にプロジェクトで許可されているティアを指定するか、プロジェクト設定で許可するサービスティアを変更してください。
401 - 認証情報が無効	原因：認証情報が無効です。対処方法：正しい API キーを使用し、正しい組織からリクエストを送信していることを確認してください。
401 - 指定した API キーが正しくない	原因：リクエストに使用した API キーが正しくありません。対処方法： API キーが正しいことを確認してください。ブラウザのキャッシュをクリアするか、新しい API キーを生成してください。
401 - API の利用には組織への所属が必要	原因：アカウントが組織に所属していません。対処方法：新しい組織への追加を希望する場合は OpenAI にお問い合わせください。既存の組織に参加する場合は、組織の管理者に組織への招待を依頼してください。
401 - 許可されていない IP アドレス	原因：リクエストの送信元 IP アドレスが、プロジェクトまたは組織の IP 許可リストに含まれていません。対処方法：許可されている IP アドレスからリクエストを送信するか、IP 許可リストの設定を更新してください。
403 - サポート対象外の国・地域	原因：サポート対象外の国または地域から API にアクセスしています。対処方法：詳細はサポート対象の国と地域を参照してください。
429 - クレジット残高なし	コード： `credit_balance_exhausted` 原因：組織の前払いクレジットを使い切りました。対処方法： API の利用を続けるには、クレジットを追加してください。
429 - リクエストのレート制限に到達	原因：リクエストの送信頻度が高すぎます。対処方法：リクエストの送信間隔を調整し、`Retry-After` ヘッダーがある場合はその指示に従ってください。レート制限ガイドを参照してください。
429 - リクエスト頻度の急増	種類： `rate_limit_error` コード： `slow_down` 原因：リクエストの送信頻度が急激に増加しました。対処方法： `Retry-After` ヘッダーがある場合はその指示に従ってください。リクエストの送信頻度を下げてから、徐々に上げてください。
429 - 組織の支出上限に到達	コード： `organization_spend_limit_exceeded` 原因：組織に設定されている支出上限に達しました。対処方法：組織の支出上限を引き上げるか、解除してください。
429 - プロジェクトの支出上限に到達	コード： `project_spend_limit_exceeded` 原因：プロジェクトに設定されている支出上限に達しました。対処方法：プロジェクト設定で支出上限を引き上げるか、解除してください。
429 - 組織の利用上限に到達	コード： `organization_usage_limit_exceeded` 原因： OpenAI が組織に割り当てた利用上限に達しました。対処方法：利用上限の引き上げを申請するか、サポートにお問い合わせください。
500 - リクエスト処理中のサーバーエラー	原因： OpenAI のサーバーで問題が発生しました。対処方法：少し待ってからリクエストを再試行し、問題が続く場合はお問い合わせください。ステータスページも確認してください。
503 - モデルの一時的な過負荷	種類： `service_unavailable_error` コード： `server_is_overloaded` 原因：リクエストしたモデルが一時的に過負荷になっています。対処方法： `Retry-After` ヘッダーがある場合はその指示に従ってから、リクエストを再試行してください。

請求に関するエラーでは、error.code を確認して具体的な原因を特定してください。より大まかな分類を示す error.type は、引き続き insufficient_quota となる場合があります。

請求、支出、利用枠に関するエラーが発生した場合、リクエストを再試行しても API へのアクセスは復旧しません。次のリクエストを送信する前に、該当するクレジットを追加するか、上限を変更してください。

WebSocket モードのエラー

Responses API の WebSocket モードを使用している場合は、次のエラーも発生することがあります。

previous_response_not_found：利用可能な状態情報から previous_response_id に対応するレスポンスを特定できません。入力コンテキスト全体を指定し、previous_response_id を null に設定して再試行してください。
websocket_connection_limit_reached：接続時間が上限の 60 分に達しました。新しい WebSocket 接続を開いて処理を続けてください。

Python ライブラリのエラーの種類

Python ライブラリが送出する例外は、RateLimitError が 429 レスポンスに、InternalServerError が 503 レスポンスに対応します。これまでレート制限と過負荷への対処でどちらか一方の例外だけを捕捉していた場合は、両方を処理し、error.code を確認してください。たとえば、動画の処理が過負荷になった場合、現在は 503 が返りますが、以前は 429 が返っていました。エンドポイントごとの変更点は移行ガイドを参照してください。

種類	概要
APIConnectionError	原因： OpenAI のサービスへの接続に問題があります。対処方法：ネットワーク設定、プロキシ設定、SSL 証明書、ファイアウォールのルールを確認してください。
APITimeoutError	原因：リクエストがタイムアウトしました。対処方法：少し待ってからリクエストを再試行し、問題が続く場合はお問い合わせください。
AuthenticationError	原因： API キーまたはトークンが無効、期限切れ、または失効済みです。対処方法： API キーまたはトークンが正しく、有効であることを確認してください。必要に応じて、アカウントのダッシュボードから新しいものを生成してください。
BadRequestError	原因：リクエストの形式が正しくないか、トークンや入力などの必須パラメータが不足しています。対処方法：エラーメッセージで具体的な問題を確認してください。呼び出している API メソッドのドキュメントを参照し、必要なパラメータをすべて正しく送信していることを確認してください。リクエストデータのエンコーディング、形式、サイズの確認が必要な場合もあります。
ConflictError	原因：別のリクエストによってリソースが更新されました。対処方法：他のリクエストが同じリソースを更新しようとしていないことを確認し、更新を再試行してください。
InternalServerError	原因： OpenAI 側で問題が発生しました。対処方法：少し待ってからリクエストを再試行し、問題が続く場合はお問い合わせください。
NotFoundError	原因：リクエストしたリソースが存在しません。対処方法：正しいリソース識別子を指定していることを確認してください。
PermissionDeniedError	原因：リクエストしたリソースへのアクセス権がありません。対処方法：正しい API キー、組織 ID、リソース ID を使用していることを確認してください。
RateLimitError	原因：割り当てられたレート制限に達したか、トラフィックを急激に増やしすぎました。対処方法：リクエストの送信間隔を調整してください。再試行する際は、再試行回数の上限を守り、`Retry-After` がある場合はその指示に従ってください。詳細はレート制限ガイドを参照してください。
UnprocessableEntityError	原因：リクエストの形式は正しいものの、処理できませんでした。対処方法：リクエストを再試行してください。

エラーが続く場合の対処方法

問題が続く場合は、チャットでサポートチームに連絡し、次の情報をお知らせください。

使用していたモデル
受信したエラーメッセージとエラーコード
送信したリクエストデータとヘッダー
リクエストのタイムスタンプとタイムゾーン
問題の診断に役立つその他の情報

サポートチームが問題を調査し、できるだけ早くご連絡します。お問い合わせが集中している場合は、回答までに時間がかかることがあります。コミュニティフォーラムに投稿することもできますが、機密情報は記載しないでください。

エラー処理

API が返すエラーは、プログラムで処理することをおすすめします。次のコード例を参考にしてください。

JavaScript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21import OpenAI from "openai";

const client = new OpenAI();

try {
  const response = await client.responses.create({
    model: "gpt-6-astra",
    input: "Hello world",
  });
  console.log(response.output_text);
} catch (error) {
  if (error instanceof OpenAI.APIConnectionError) {
    console.error("Failed to connect to the OpenAI API:", error.message);
  } else if (error instanceof OpenAI.RateLimitError) {
    console.error("OpenAI API request exceeded its rate limit:", error.message);
  } else if (error instanceof OpenAI.APIError) {
    console.error("OpenAI API returned an error:", error.status, error.message);
  } else {
    throw error;
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15import openai
from openai import OpenAI

client = OpenAI()

try:
    response = client.responses.create(model="gpt-6-astra", input="Hello world")
except openai.APIConnectionError as e:
    print(f"Failed to connect to OpenAI API: {e}")
except openai.RateLimitError as e:
    print(f"OpenAI API request exceeded rate limit: {e}")
except openai.APIError as e:
    print(f"OpenAI API returned an API Error: {e}")
else:
    print(response.output_text)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28package main

import (
	"context"
	"errors"
	"fmt"

	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/responses"
)

func main() {
	client := openai.NewClient()
	response, err := client.Responses.New(context.Background(), responses.ResponseNewParams{
		Model: "gpt-6-astra",
		Input: responses.ResponseNewParamsInputUnion{OfString: openai.String("Hello world")},
	})
	if err != nil {
		var apiError *openai.Error
		if errors.As(err, &apiError) {
			fmt.Println("OpenAI API returned an API error:", apiError)
			return
		}
		fmt.Println("Failed to connect to OpenAI API:", err)
		return
	}
	fmt.Println(response.OutputText())
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.errors.OpenAIServiceException;
import com.openai.models.responses.ResponseCreateParams;

try {
  var response =
      client
          .responses()
          .create(
              ResponseCreateParams.builder().model("gpt-6-astra").input("Say hello.").build());

  response.output().stream()
      .flatMap(item -> item.message().stream())
      .flatMap(message -> message.content().stream())
      .flatMap(content -> content.outputText().stream())
      .forEach(text -> System.out.println(text.text()));
} catch (OpenAIServiceException error) {
  System.err.println(error.getMessage());
}

1
2
3
4
5
6
7
8
9require "openai"

client = OpenAI::Client.new
begin
  response = client.responses.create(model: "gpt-6-astra", input: "Say hello.")
  puts(response.output_text)
rescue OpenAI::Errors::APIError => error
  warn(error.message)
end

おすすめ

はじめに

基本概念

SDK と CLI

クラウドプロバイダー

リソース

レガシー API

モデルの選び方

テキストとコード

プロンプトの書き方

推論

画像

リアルタイム処理とオーディオ

特化型モデル

Agents API

Agents SDK

ChatKit

検索と情報取得

ツールとデータの接続

ツールを使ったワークフローの構築

コンピューターとコード

メディア

GPT-Live

Realtime API

音声を使った開発

接続

音声処理

本番稼働の開始

パフォーマンスと品質

評価

コストとスループット

安全性とガバナンス

インフラとアクセス

業務運営

基本概念

計画

開発

テストと公開

コンバージョン仕様

ガイド

リソース

アイデンティティ

ChatGPT プランの利用状況

ガイド

ファイルのアップロード

API

効果測定

広告主向け API

API リファレンス

はじめに

はじめに

基礎

探す

対応プラットフォーム

リリース

ワークフロー

できること

Sites

dot

ChatGPT Space

リファレンス

カスタマイズ

設定ファイル

エージェントの設定

ChatGPT と Codex の機能拡張

Linux

Windows

開発ワークフロー

機能拡張と自動化

環境

Codex Cloud

Codex を使った開発

サードパーティ連携

リファレンス

権限

Codex Security

サイバー安全対策

はじめに

機能設定

ID とアクセス管理