APIリファレンス

レスポンス

OpenAI Responses形式のAPIでマルチモーダルなレスポンスを作成します。

Responses APIは、統一された入力フィールドとして input を使用します。新しいOpenAI Responses形式のモデル向けに設計されており、ストリーミング、ツール、推論オプション、レスポンスの継続をサポートします。

エンドポイント

メソッドパス説明
POST/v1/responsesレスポンスを作成
POST/v1/responses/compactフィールドを減らしたレスポンス圧縮API

リクエストフィールド

フィールド必須説明
modelstringはいモデルID
inputstring or arrayはい入力内容。input_textinput_imageinput_file を含めることができます
instructionsstringいいえシステムレベルの指示
streambooleanいいえSSEストリームを返します
max_output_tokensintegerいいえ最大出力トークン数
temperature, top_pnumberいいえサンプリング制御
tools, tool_choicearray/objectいいえツール設定
parallel_tool_callsbooleanいいえ並列ツール呼び出しを許可
max_tool_callsintegerいいえ最大ツール呼び出し数
previous_response_idstringいいえ前回のレスポンスから継続
reasoningobjectいいえeffortsummary などの推論オプション
textobjectいいえテキスト出力設定
include, truncationanyいいえOpenAI Responses拡張フィールド
metadata, useranyいいえメタデータまたはユーザー識別子
store, service_tier, safety_identifieranyいいえOpenAI拡張フィールド。チャネル設定によりフィルタされる場合があります

curl

curl https://api.tensoraxis.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "Explain what an API gateway is in two sentences"
  }'

マルチモーダル入力

{
  "model": "gpt-4o",
  "input": [
    {
      "role": "user",
      "content": [
        {"type": "input_text", "text": "Describe this image"},
        {"type": "input_image", "image_url": "https://example.com/image.png"}
      ]
    }
  ]
}

圧縮API

/v1/responses/compact は、より小さいリクエストボディを受け付けます:

フィールド必須説明
modelstringはいモデルID
inputanyいいえ圧縮対象の入力
instructionsanyいいえ指示
previous_response_idstringいいえ前回のレスポンスID

レスポンス形式

レスポンスはOpenAI Responses形式に従います。主なフィールドには idmodeloutputusage が含まれます。ストリーミングレスポンスは、SSEイベントとして差分コンテンツを返します。