Responses API

POST /v1/responses

OpenAI Responses API と互換性があります。構造化された入力項目、ツールの使用、組み込みの推論をサポートします。gateway は上流のプロバイダーへ透過的にプロキシします。

リクエストボディ

パラメータ	型	説明
`model`*	`string`	使用するモデルの ID（例：gpt-5.4、gpt-5.4-mini）。
`input`*	`string \| array`	テキスト文字列、または入力項目の配列（role と content を持つメッセージオブジェクト）。
`stream`	`boolean`	true の場合、SSE イベントのストリームを返します。デフォルト：false。
`temperature`	`number`	サンプリング温度 0–2。デフォルト：1。
`max_output_tokens`	`integer`	レスポンスで生成する最大 token 数。
`tools`	`array`	モデルが呼び出せるツール定義のリスト。
`reasoning`	`object`	o シリーズモデル向けの推論設定（例：{ "effort": "high" }）。

リクエスト例

POST /v1/responses
Authorization: Bearer YOUR_API_KEY

{
  "model": "gpt-5.4-mini",
  "input": "What is the capital of France?",
  "max_output_tokens": 256
}

レスポンス例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1714000000,
  "model": "gpt-5.4-mini",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "The capital of France is Paris." }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 9,
    "total_tokens": 21
  }
}

ℹ

Responses API は OpenAI モデルとやり取りするための推奨される方法です。ツールの使用、構造化出力、推論設定をネイティブにサポートします。