Skip to main content
Responses は OpenAI のネイティブなステートフル応答プロトコルです。TokenLab は、モデル詳細が Responses 形式を公開し、同一プロトコルの upstream ルートがある場合にのみ提供します。モデル名やプロバイダー名から推測せず、Chat Completions へフォールバックしません。未知のフィールド、明示的な null、空配列を含む JSON 形状を保持し、best-effort で転送します。

リクエストボディ

string
必須
使用するモデルの ID。利用可能なオプションは Models を参照してください。
string | array
再利用可能な prompt を使う場合、または previous_response_id で保存済みレスポンスを継続する場合、input は省略できます。会話を構成する入力アイテムのリスト。各アイテムは次のいずれかになります:
  • message: ロールとコンテンツを持つ会話メッセージ
  • function_call: 関数呼び出しのリクエスト
  • function_call_output: 関数呼び出しからの出力
マルチモーダル入力の場合、message.content はプレーンな文字列かコンテンツブロックの配列のいずれかになります。GPT-5.4 系列のような画像対応モデルでは、URL や Base64 文字列をプレーンテキストに直接埋め込むのではなく、input_image ブロックとして画像を渡してください。例のコンテンツブロック:
  • { "type": "input_text", "text": "Describe this image" }
  • { "type": "input_image", "image_url": "https://example.com/image.jpg" }
  • { "type": "input_image", "image_url": "data:image/png;base64,..." }
string
モデルへのシステム指示(system message と同等)。
integer
生成する最大の token 数。
number
デフォルト:"1"
サンプリングの温度。0 から 2 の間で指定します。
array
モデルが呼び出せるツール一覧です。TokenLab はローカル allowlist を設けずネイティブ定義を転送し、対応する種類や組み合わせは選択された upstream が判断します。
boolean
デフォルト:"false"
true の場合、イベントのストリームを返します。
string
会話を続けるための前回のレスポンスの ID。
boolean
デフォルト:"true"
後で取得するためにレスポンスを保存するかどうか。
object
追跡目的でレスポンスに添付するメタデータ。
object
テキスト生成の設定オプション。text.format の挙動は選択したモデルと経路によって異なり、すべてのモデルで一様に保証されるわけではありません。
boolean
デフォルト:"true"
複数のツール呼び出しを並列で許可するかどうか。
number
Nucleus サンプリングのパラメータ(0〜1)。
object
GPT-5 系列などの推論対応モデル向けの推論設定。
  • effort (string): 推論の努力レベル(lowmediumhigh

レスポンス

string
レスポンスの一意の識別子。
string
常に response です。
integer
レスポンスが作成された時刻の Unix タイムスタンプ。
array
モデルが生成した出力アイテムのリスト。
object
token 使用統計。