Responses API と Chat Completions の違いと選び方

AI アプリケーションで Responses API と Chat Completions のどちらを使うかを決める前に、リクエスト形式、ストリーミング、ツール、プロバイダーとの互換性を比較します。

Responses API と Chat Completions の違いと選び方

Responses API と Chat Completions はどちらも言語モデルにプロンプトを送信しますが、入力、出力、ツール、ストリーミングの構成が異なります。どちらを選ぶかは、「新しいエンドポイントならどのプロバイダーでも自動的に使える」という前提ではなく、クライアントとモデルの仕様から判断する必要があります。

最も簡単な判断基準は次のとおりです。

  • Responses のアイテム、ツールイベント、Responses のストリーミングのライフサイクルを前提とするコーディングエージェントやアプリケーションには、Responses API を使用します。
  • 幅広く互換性のあるチャットクライアントや、OpenAI 形式のモデルを Chat Completions の無変換パススルーで提供しているプロバイダーファミリーには、Chat Completions を使用します。

選択したモデルが対応している API 形式は、必ずモデルと料金で確認してください。

プロトコルの比較

比較項目 Responses API Chat Completions
主な入力の形 input と型付きの入力アイテム messages 配列
出力の構造 型付きの出力アイテムとイベント アシスタントメッセージの choices と差分
ストリーミング Responses のイベントストリーム Chat Completions のチャンクストリーム
ツールの動作 型付きのツール呼び出しアイテムとツール出力アイテム アシスタントメッセージに付随するツール呼び出し
適した用途 エージェント、コーディングツール、Responses ネイティブのアプリケーション チャットクライアント、幅広く対応している OpenAI 互換プロバイダー
モデルの移植性 Responses 向けに検証済みのモデルのみ Chat Completions 向けに検証済みのモデルのみ

この表は通信上の仕様を示したものです。Modelflare があらゆるプロバイダー機能を 2 つの形式の間で変換するという意味ではありません。

Responses API が適している場合

クライアントが 1 回のモデル実行を 1 件のアシスタントメッセージではなく、型付きアイテムの連続として扱う場合は、/v1/responses を選択します。これは、可視テキスト、推論の要約、関数の引数、カスタムツールの入力などのイベントを区別する必要があるコーディングエージェントでよく見られる構成です。

最小限のリクエストは次のとおりです。

curl -sS https://modelflare.dev/v1/responses \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "List the three checks to make before an API migration.",
    "stream": true
  }'

Responses のストリーミングは、エンドツーエンドで検証してください。Chat Completions のチャンクは理解できても Responses のイベントを理解できないクライアントは、接続には成功しても、有用な出力を表示できないことがあります。

Chat Completions のほうが安全な場合

アプリケーションが system、user、assistant、tool のメッセージを中心に構築されている場合や、選択したプロバイダーファミリーが OpenAI 互換の Chat Completions エンドポイントをドキュメントで公開している場合は、/v1/chat/completions を選択します。

curl -sS https://modelflare.dev/v1/chat/completions \
  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "system", "content": "Answer concisely."},
      {"role": "user", "content": "What should an API health check verify?"}
    ],
    "stream": true
  }'

OpenAI 以外のプロバイダーファミリーについては、Modelflare は Chat Completions の無変換パススルーを提供できます。これにより、プロバイダー固有の推論や検索の制御といった独自のリクエストフィールドが、変更されないままサービス提供元に届きます。この動作は意図的に範囲を絞ったものであり、Responses との完全な互換性をうたうものではありません。

モデル名だけで選ばない

次の 3 点を個別に確認する必要があります。

  1. API キーがモデルにアクセスできること。 アクセスできるかどうかは、キーと利用可能なモデルグループによって決まります。
  2. モデルがエンドポイントに対応していること。 /v1/models に含まれるモデルでも、両方のリクエスト形式で自動的に使えるわけではありません。
  3. クライアントがストリームを理解できること。 Responses のイベントと Chat Completions のチャンクは、クライアントにとって別々の仕様です。

いずれかの確認を満たさないままエンドポイントのパスだけを切り替えると、明確な互換性エラーが、空のレスポンスや一部しか表示されないレスポンスに変わってしまうことがあります。

ツールと構造化出力の移行

既存の連携を移行する前に、次の点を確認します。

  • クライアントが使用しているツール定義のスキーマを比較する
  • ツール呼び出しの ID とツールの出力がどのように返されるかを確認する
  • 0 や false を削除せず、明示的に指定された任意の値を保持する
  • 変更せずにパススルーする必要がある独自フィールドをプロバイダーが求めていないか確認する
  • 可視テキストの差分を含まない場合がある、ツールのみのレスポンスをテストする
  • クライアントが完了と使用量をどのように検出するかを確認する

同じプロンプトから似たテキストが返ってくるだけでは、プロトコルのテストとして不十分です。実際のテストには、アプリケーションが依存している機能を含める必要があります。

実践的な選択の流れ

  1. モデルと料金を開き、モデルとグループを選択します。
  2. 対応している API 形式を確認します。
  3. クライアント別のガイドがある場合は、Modelflare ドキュメントの手順に従います。
  4. 非ストリーミングのリクエストを 1 件送信します。
  5. ストリーミングのリクエストを 1 件送信します。
  6. ツールまたは構造化出力を実際に試します。
  7. 利用ログで、そのリクエストのステータス、タイミング、トークン使用量、コストを確認します。

Responses API は Chat Completions をすべて置き換えるものではなく、Chat Completions が時代遅れになったわけでもありません。正しい形式とは、クライアント、選択したモデル、サービス提供元の仕様がいずれも対応している形式です。

形式を決めたら、AI API ストリーミングガイドを参考に、イベントパーサー、タイミング指標、キャンセル、タイムアウトの方針を実装してください。