レスポンスの作成
OpenAI互換のレスポンスAPIを使用してモデル出力を生成します。
テキストまたは構造化されたモデル入力と統一された出力オブジェクトには、レスポンスAPIの形式を使用します。
/openai/v1/responsesリクエストボディ
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
model | 文字列 | はい | AnyIntによってルーティングされるモデル識別子。 |
input | 文字列または配列 | はい | テキストまたは構造化された入力アイテム。 |
stream | ブール値 | いいえ | サポートされている場合はサーバー送信イベントを返します。 |
reasoning.effort | 文字列 | いいえ | モデルに応じた推論強度。暗黙的に低減することなくそのまま転送されます。 |
tools | 配列 | いいえ | カスタムツールを含むツール宣言。 |
レスポンス
リクエストが完了すると、識別子、ステータス、生成された出力を含むレスポンスオブジェクトが返されます。
ツール履歴と検証
カスタムツール呼び出しとマルチパートツール出力は、元の順序とUnicodeテキストを保持します。アシスタントの output_text 部分が省略されているかnullの場合、空の annotations および logprobs 配列が提供され、リレーが無効なnullメタデータとして再構築するのを防ぎます。プロバイダーのキープアライブメッセージは会話履歴から除外されます。
推論強度のサポートは、選択したモデルとアップストリームに依存します。構造化された拒否はフィールドを特定します(例:error.code: "invalid_value"、error.param: "reasoning.effort")。特定できない、またはリレーによって生成されたフォーマットの拒否は、有効なクライアント履歴を不正な形式として識別するのではなく、アップストリームエラーを返します。
ストリーミングと復旧
正常なストリームは response.completed で終了します。出力制限により response.incomplete で終了する場合があります。アップストリームの障害、タイムアウト、または早期EOFは response.failed を生成します。失敗したストリームは、捏造された成功終端や従来の [DONE] マーカーを受け取ることはありません。HTTPステータスが200であっても終端イベントを確認してください。終端ストリームの失敗は、ディスパッチされた作業の自動再実行を承認しません。
ハートビートにはSSEコメントが使用されます。プロバイダーの response.metadata イベントおよび SSE-Keep-Alive 出力項目は除外されます。イベントの sequence_number の値は単調に増加します。
オプションの x-client-message-id および x-resume-message-id ヘッダーは、イベントオフセット復旧を有効にします。x-anyint-resume-offset-unit: sse-event はそのオフセットを示し、x-anyint-stream-replayed: true はリプレイであることを識別します。これらを選択しないクライアントは、これらの拡張ヘッダーを無視できます。
互換性エイリアス
既存のクライアントは引き続き/v1/responsesを使用できます。新しい統合では/openai/v1/responsesを使用する必要があります。