Responses

Responses API は、OpenAI Responses プロトコルを使用するクライアント、コーディングエージェント、新しい世代のアプリケーションフレームワークに適しています。統一された入力構造、ツール呼び出し、推論制御、またはより複雑なレスポンス構造が必要な場面でよく使われます。

Endpoint

POST /v1/responses

完全な URL：

https://www.routeapi.ai/v1/responses

リクエスト例

curl https://www.routeapi.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "RouteAPI の主な用途を説明してください"
  }'

よく使われるパラメータ

フィールド	型	必須	説明
model	string	はい	モデル ID
input	string/array	はい	入力内容
instructions	string	いいえ	システムレベルの指示
stream	boolean	いいえ	ストリーミング出力を使うかどうか
tools	array	いいえ	ツール定義
tool_choice	string/object	いいえ	ツール選択ポリシー
temperature	number	いいえ	サンプリング温度
max_output_tokens	number	いいえ	最大出力 token 数

Chat Completions との違い

項目	Chat Completions	Responses
入力構造	messages	input + instructions
互換範囲	従来の OpenAI SDK 互換クライアントで最も多い	新しいプロトコルのクライアントやコーディングエージェントでよく使われる
ツール呼び出し	対応。選択したモデルに依存します	対応。通常は表現力がより高くなります
推奨シーン	汎用チャット、互換接続	新規プロジェクト、コーディングエージェント、複雑なタスク

接続の推奨事項

• クライアントが OpenAI Responses プロトコルを明示的に要求する場合は、/v1/responses を使用します。
• クライアントが従来の OpenAI Chat Completions のみに対応している場合は、/v1/chat/completions を使用します。
• 同じモデルが Responses に対応しているかどうかは、RouteAPI のモデル設定とサービス能力に依存します。