GPT 全モデルインターフェース - Responses 完全なパラメータ
- GPT シリーズのテキストモデル向け OpenAI 互換 Responses API。具体的なモデルは
modelで選択します(指定可能な値はすべてmodelパラメータの対照表を参照) - 全シリーズが推論モデルで、推論の深さは
reasoning.effortで制御します。推論 token は出力 token として課金されます - Prompt キャッシュは自動的に有効:キャッシュにヒットした入力 token はより安いキャッシュ料金で課金されます
- 同期モードとストリーミング(SSE)モードに対応
- サーバーサイドツール:
web_search(ウェブ検索)、code_interpreter(コード実行)、file_search(ドキュメント検索) - 通常の
functionツール(クライアント側の関数呼び出し)にも対応 - 複数ターンの会話は
previous_response_idでつなげられます - 注意 一部のパラメータは対応範囲がモデルごとに異なります。詳細は下記の各パラメータの説明をご覧ください
https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。web_search、code_interpreter、file_search、mcp)はサーバー側で実行されるためクライアントが結果を返す必要はなく、この API でのみ提供されます。Chat Completions エンドポイントは通常の function ツール呼び出しのみに対応します。background: true によるバックグラウンド非同期モードには対応しておらず、レスポンス ID による取得・キャンセル・削除のエンドポイントも提供していません。長時間の生成が必要な場合は stream: true を使って接続を維持してください。image_generation ツールは本シリーズのモデルでは利用できません。画像生成には画像シリーズのモデル API をご利用ください。id を次のターンの previous_response_id に指定すれば、コンテキストを引き継げます。レスポンスには保持期限があり、期限が切れるとその ID は無効になり、リクエストは新しい会話として処理されます。コンテキストの正確性が強く求められる場面では、input の履歴全体をご自身で管理することを推奨します。承認
ボディ
呼び出すモデル:
gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.2, gpt-5.1 "gpt-5.6-sol"
モデル入力:単なる文字列、または入力項目の配列。
入力項目の content は input_text(テキスト)と input_image(画像)の 2 種類のブロックに対応しています:
画像
image_urlに画像の公開 URL を渡しますimage_urlは必ず文字列で指定します。{ "url": "..." }と書くと400が返されますdetailはimage_urlと同じ階層に置きます(その中に入れ子にはしません)。auto(デフォルト)/low/high/original- 画像は正常にダウンロードできる必要があり、できない場合は
400が返されます
ツール結果
- 配列には前のターンの
function_call_outputなどのツール結果項目を差し戻すこともできます
注意 この API のブロックの種類は Chat Completions API とは異なります(Chat は text / image_url を使用)。両者は混在させられず、誤って指定すると 400 が返されます。
"Search for AI news from the past week and summarize it in three sentences."
システムレベルの指示。input の先頭にシステムメッセージを 1 件挿入するのと同等です。previous_response_id で会話を継続する場合、このパラメータは前のターンから引き継がれないため、毎ターン渡す必要があります。
"You are a concise assistant. Answer in no more than three sentences."
ストリーミングでレスポンスを返すかどうか(SSE イベント。response.completed で終了)。デフォルトは false。
false
生成する最大 token 数(推論 token を含む)。上限に達した場合、status は incomplete になります。
2048
推論の制御。
effort(推論の深さ)の指定可能な値はモデルによって異なります:
summary(推論サマリー):auto / concise / detailed。全シリーズで利用できます。有効にすると output に reasoning 項目が現れます。
mode(推論モード):standard / pro。gpt-5.6 ファミリーのみ対応。
context(推論のコンテキスト範囲):auto / current_turn / all_turns。gpt-5.6 ファミリーのみ対応。
推論 token は出力 token として課金され、usage.output_tokens_details.reasoning_tokens に計上されます。
出力テキストの制御:
format:{"type": "text"}(デフォルト)、{"type": "json_object"}、または構造化結果を出力する{"type": "json_schema", "name": "...", "schema": {...}, "strict": true}verbosity:low/medium/high。回答の詳しさを制御します
ツールの宣言。サーバーサイドツールはサーバー側で実行されるため、クライアントが結果を返す必要はありません:
通常の function ツール(クライアント側の関数呼び出し)にも対応しています。
注意 image_generation は本シリーズのモデルでは利用できません。画像シリーズのモデル API をご利用ください。
ツールの選択を制御します:"auto"(デフォルト)/ "none" / "required"、または特定のツールを指定するオブジェクト(例:{"type": "web_search"})。
none, auto, required このレスポンスで許可されるツール呼び出しの合計回数の上限。
5
1 ターン内でモデルが複数のツールを並列に呼び出せるかどうか。デフォルトは true。
注意 false に設定できるのは gpt-5.6 ファミリーと gpt-5.5 のみです。gpt-5.4 / gpt-5.2 / gpt-5.1 ではこのパラメータは無効で、常に true として動作します。
true
前のレスポンスの id。複数ターンの会話をつなげるために使用し、履歴メッセージを再送信する必要がなくなります。
注意 store: true(デフォルト値)と併用する必要があります。レスポンスには保持期限があり、期限が切れるとその ID は無効になります。この場合、リクエストは新しい会話として処理され、コンテキストは引き継がれません。コンテキストの正確性が強く求められる場面では、input の履歴全体をご自身で管理することを推奨します。
"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"
このレスポンスをサーバー側に保持するかどうか。保持されたレスポンスのみ previous_response_id から参照できます。デフォルトは true。
注意 false に設定できるのは gpt-5.6 ファミリーと gpt-5.5 のみです。gpt-5.4 / gpt-5.2 / gpt-5.1 ではこのパラメータは無効で、常に true として動作します。保持を望まない場合は、無効化に対応したモデルをお選びください。
true
レスポンスに追加で返すよう要求する内容。指定可能な値:
reasoning.encrypted_contentmessage.output_text.logprobsweb_search_call.resultsweb_search_call.action.sourcesfile_search_call.resultscode_interpreter_call.outputsmessage.input_image.image_urlcomputer_call_output.output.image_url
サンプリング温度。値の範囲は 0 ~ 2。値が低いほど出力が決定的になります。
注意 gpt-5.4 / gpt-5.2 / gpt-5.1 では値 0 は無効です(渡さなかった場合と同じ扱いになり、デフォルト値 1 が適用されます)。より決定的な出力が必要な場合は 0.01 など 0 より大きい値をご利用ください。
0 <= x <= 20.7
Nucleus サンプリングのパラメータ。値の範囲は 0 ~ 1。temperature と同時に調整しないことを推奨します。
0 <= x <= 10.9
各位置で返される候補 token の数。値の範囲は 0 ~ 20。include: ["message.output_text.logprobs"] と併用する必要があります。
注意 gpt-5.6 ファミリーと gpt-5.5 のみ対応。その他のモデルはこのパラメータに対応していません。
0 <= x <= 202
Frequency ペナルティ。値の範囲は -2 ~ 2。内容の繰り返しが起きる確率を下げます。
注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。
-2 <= x <= 20.5
Presence ペナルティ。値の範囲は -2 ~ 2。モデルが新しい話題に触れることを促します。
注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。
-2 <= x <= 20.5
コンテキストがウィンドウを超えた場合の処理方法:disabled(デフォルト。そのままエラーを返す)または auto(中間部分を自動的に切り詰める)。
auto, disabled "auto"
長い会話の自動圧縮設定。例:[{"type": "compaction", "compact_threshold": 100000}]。コンテキストがしきい値を超えると履歴が自動的に圧縮されます。
注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。
キャッシュのグループ化キー。同じプレフィックスを持つリクエストに同じ値を渡すと、Prompt キャッシュのヒット率が向上します。
"app-agent-v1"
Prompt キャッシュの保持ポリシー:in_memory(デフォルト)または 24h(キャッシュの保持期間を延長)。
in_memory, 24h "in_memory"
作成済みの Prompt テンプレートを参照します。形式は {"id": "pmpt_xxx", "version": "1", "variables": {...}}。
カスタムのキーと値のペア。レスポンスにそのまま返されるため、業務側でのタグ付けに便利です。キーと値はいずれも文字列です。
エンドユーザーの安定した識別子。不正利用の追跡に使用します。
注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。
"user-1024"
エンドユーザー識別子。呼び出し元を区別するために使用します。
"user-1024"
レスポンス
レスポンス生成成功(JSON オブジェクト、または stream=true の場合は response.completed で終わる SSE イベントストリーム)
このレスポンスの一意の ID。次のターンの previous_response_id として使用できます
"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"
レスポンスタイプ
response "response"
レスポンスのステータス:completed は正常終了、incomplete は max_output_tokens への到達などの理由で完了しなかった状態、failed は生成失敗
completed, incomplete, failed "completed"
実際に使用されたモデル名
"gpt-5.6-sol"
作成タイムスタンプ
1786705221
生成順に並んだ出力項目:reasoning 項目(推論サマリー / 暗号化された推論内容)、ツール呼び出し項目(web_search_call、code_interpreter_call など)、そして最後に output_text の内容を含む message 項目。
status が incomplete の場合にその理由を示します
Token 使用量の統計。Prompt キャッシュは自動的に有効となり、キャッシュにヒットした入力 token はより安いキャッシュ料金で課金されます。
リクエストで渡したカスタムのキーと値のペア。そのまま返されます