OpenAI responses
Text
/v1/responses
텍스트 생성, 다중 모드 입력 및 구조화된 출력을 위한 통합 OpenAI 호환 응답 엔드포인트입니다.
POST
OpenAI responses
テキスト生成、構造化出力、ツール呼び出し、およびマルチモーダル入力用の統合応答オブジェクトを作成します。
chat.completions と比較して、このエンドポイントは、テキスト、画像、推論コントロール、ツールがすべて 1 つの応答モデルを共有しているため、新しい統合に適しています。サポートされるフィールドはモデルによって異なります。
統合ガイダンス
Authorization: Bearer {API_KEY}で認証する- テキスト、JSON 出力、ツール呼び出し、および将来のマルチモーダル ワークフローに 1 つのサーフェスが必要な場合は、このエンドポイントを優先します。
previous_response_idを使用して、完全な履歴を再送信せずに会話を続行します- 推論モデルのワークフローの場合、
reasoning、max_output_tokens、およびtoolsをサーバー側ゲートウェイに一元化します。 - ストリーミング クライアントは、最後のペイロードを待つのではなく、増分イベントを消費する必要があります。
リクエストのハイライト
inputは主要な入力フィールドであり、テキストまたはマルチモーダル コンテンツ ブロックを含めることができますmodel応答のターゲット モデルを選択しますprevious_response_idは、会話中にターンを連鎖させる主な方法です- 構造化出力の場合、明示的な JSON フォーマット要件を宣言し、サーバー側を検証します。
- ツールを使用する場合は、
toolsを渡し、ツール呼び出しの出力を明示的に処理します。
回答のハイライト
- 単純なテキストは
output_textから読み取れることが多い - より豊富な結果は
output[]から読み取る必要があります - ツール呼び出し、推論トレース、およびマルチモーダル出力はすべて同じ応答オブジェクトを共有します
- 使用状況とステータスのメタデータは、テキストのみから推測するのではなく、応答オブジェクトから読み取る必要があります。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
