Responses API
POST https://llmoxy.com/v1/responses は JSON 本文を受け取ります。リクエストヘッダー:
Authorization: Bearer <LLMOXY_API_KEY>
Content-Type: application/jsonゲートウェイは本文を固定の構造として解釈します。model が空、input が無い、または max_output_tokens が 1,073,741,823 を超えるリクエストは拒否されます。background はこの構造に含まれません。
リクエスト本文の透過が有効でない場合、下表の項目だけを残し、既定で service_tier、safety_identifier、stream_options.include_obfuscation を除きます。store は残します。空値を許す数値の明示的な 0 と、stream の明示的な false は送信されます。stream_options 内の false は再構築時に省略されます。表に無い項目は送信されません。
リクエスト項目
| 項目 | 型 | 必須 | ゲートウェイの扱い |
|---|---|---|---|
model | string | はい | 空でないモデル ID。 |
input | string または array | はい | 必須です。文字列は 1 件の入力テキストとして数えます。配列要素には role を含められます。文字列の content は入力テキストです。配列の content では input_text、input_image、input_file を認識します。image_url と file_url は文字列、または url を持つオブジェクトです。 |
include | JSON | いいえ | 受け取ったまま残します。 |
conversation | JSON | いいえ | 受け取ったまま残します。 |
context_management | JSON | いいえ | 受け取ったまま残します。 |
instructions | JSON | いいえ | 受け取ったまま残します。通常は文字列です。 |
max_output_tokens | number | いいえ | 空値を許します。明示的な 0 は残します。 |
top_logprobs | number | いいえ | 空値を許します。明示的な 0 は残します。 |
metadata | JSON | いいえ | 受け取ったまま残します。 |
parallel_tool_calls | JSON | いいえ | 受け取ったまま残します。明示的な false は残します。 |
previous_response_id | string | いいえ | 空文字は省略します。 |
reasoning.effort | string | いいえ | 空文字は省略します。値は検証しません。 |
reasoning.summary | string | いいえ | 空文字は省略します。値は検証しません。 |
service_tier | string | いいえ | 既定で除きます。 |
store | JSON | いいえ | 既定で残します。明示的な false は残します。 |
prompt_cache_key | JSON | いいえ | 受け取ったまま残します。 |
prompt_cache_retention | JSON | いいえ | 受け取ったまま残します。 |
safety_identifier | JSON | いいえ | 既定で除きます。 |
stream | boolean | いいえ | 省略時は非ストリームです。明示的な false は残します。 |
stream_options.include_usage | boolean | いいえ | 再構築時、false は省略します。 |
stream_options.include_obfuscation | boolean | いいえ | 既定で除きます。再構築時、false は省略します。 |
temperature | number | いいえ | 空値を許します。明示的な 0 は残します。 |
text | JSON | いいえ | 受け取ったまま残します。 |
tool_choice | JSON | いいえ | 受け取ったまま残します。 |
tools | JSON | いいえ | 受け取ったまま残します。 |
top_p | number | いいえ | 空値を許します。明示的な 0 は残します。 |
truncation | JSON | いいえ | 受け取ったまま残します。 |
user | JSON | いいえ | 受け取ったまま残します。 |
max_tool_calls | number | いいえ | 空値を許します。明示的な 0 は残します。 |
prompt | JSON | いいえ | 受け取ったまま残します。 |
enable_thinking | JSON | いいえ | 受け取ったまま残します。 |
preset | JSON | いいえ | 受け取ったまま残します。 |
grok-4.6 と grok-4.7
2026-10-03 の https://llmoxy.com/v1/responses へのストリーム呼び出しでは、grok-4.6 と grok-4.7 がどちらも HTTP 200 と同じイベント列を返しました。
| モデル | HTTP | 応答の model | status | 本文 | input / output / total |
|---|---|---|---|---|---|
grok-4.6 | 200 | grok-4.6 | completed | pong | 212 / 98 / 310 |
grok-4.7 | 200 | grok-4.7 | completed | pong | 1248 / 55 / 1303 |
grok-4.6 の input_tokens_details.cached_tokens は 128、output_tokens_details.reasoning_tokens は 97 でした。grok-4.7 では 1152 と 54 でした。
表示テキストは、output のうち type が message の項目にある、content のうち type が output_text の text です。両モデルは先に type が reasoning の項目を出します。response.completed でも、その reasoning 項目の status は in_progress のままです。
この 2 つのモデルのリクエストは本文透過が有効なため、次節の最小 JSON はクライアントが書いたまま送信されます。
成功した最小リクエスト
grok-4.6 も同じ本文で、model だけ grok-4.6 にします。
応答の Content-Type は text/event-stream です。各イベントは event: 行と data: 行です。ゲートウェイは解析できたイベントの元 JSON を転送し、イベント名には JSON の type を使います。ストリームは最後の response.completed で終わります。
両モデルのイベント名と順序は同じです。
response.created、response.in_progress、response.output_item.added、response.reasoning_summary_part.added、response.reasoning_summary_text.delta、response.reasoning_summary_text.delta、response.reasoning_summary_text.done、response.reasoning_summary_part.done、response.output_item.done、response.output_item.added、response.content_part.added、response.output_text.delta、response.output_text.done、response.content_part.done、response.output_item.done、response.completed。
以下は grok-4.7 の実測です。応答 ID と項目 ID はプレースホルダです。その他の項目は当回の応答と一致します。
event: response.created
data: {"type":"response.created","sequence_number":0,"response":{"object":"response","id":"resp_example","created_at":1791015238,"model":"grok-4.7","output":[],"status":"in_progress"},"output_index":0}
event: response.in_progress
data: {"type":"response.in_progress","sequence_number":1,"response":{"object":"response","id":"resp_example","created_at":1791015238,"model":"grok-4.7","output":[],"status":"in_progress"},"output_index":0}
event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":2,"output_index":0,"item":{"id":"item_reasoning","type":"reasoning","status":"in_progress","summary":[]}}
event: response.reasoning_summary_part.added
data: {"type":"response.reasoning_summary_part.added","sequence_number":3,"output_index":0,"item_id":"item_reasoning","part":{"type":"summary_text","text":""},"summary_index":0}
event: response.reasoning_summary_text.delta
data: {"type":"response.reasoning_summary_text.delta","sequence_number":4,"output_index":0,"item_id":"item_reasoning","delta":"The user wants a reply","summary_index":0}
event: response.reasoning_summary_text.delta
data: {"type":"response.reasoning_summary_text.delta","sequence_number":5,"output_index":0,"item_id":"item_reasoning","delta":" of exactly \"pong\".","summary_index":0}
event: response.reasoning_summary_text.done
data: {"type":"response.reasoning_summary_text.done","sequence_number":6,"output_index":0,"item_id":"item_reasoning","text":"The user wants a reply of exactly \"pong\".","summary_index":0}
event: response.reasoning_summary_part.done
data: {"type":"response.reasoning_summary_part.done","sequence_number":7,"output_index":0,"item_id":"item_reasoning","part":{"type":"summary_text","text":"The user wants a reply of exactly \"pong\"."},"summary_index":0}
event: response.output_item.done
data: {"type":"response.output_item.done","sequence_number":8,"output_index":0,"item":{"id":"item_reasoning","type":"reasoning","summary":[{"text":"The user wants a reply of exactly \"pong\".","type":"summary_text"}]}}
event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":9,"output_index":1,"item":{"id":"item_message","type":"message","role":"assistant","content":[],"status":"in_progress"}}
event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":10,"output_index":1,"item_id":"item_message","content_index":0,"part":{"type":"output_text","text":"","annotations":[]}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":11,"output_index":1,"item_id":"item_message","content_index":0,"delta":"pong"}
event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":12,"output_index":1,"item_id":"item_message","content_index":0,"text":"pong"}
event: response.content_part.done
data: {"type":"response.content_part.done","sequence_number":13,"output_index":1,"item_id":"item_message","content_index":0,"part":{"type":"output_text","text":"pong","annotations":[]}}
event: response.output_item.done
data: {"type":"response.output_item.done","sequence_number":14,"output_index":1,"item":{"id":"item_message","type":"message","role":"assistant","content":[{"type":"output_text","annotations":[],"text":"pong"}],"status":"completed"}}
event: response.completed
data: {"type":"response.completed","sequence_number":15,"response":{"object":"response","id":"resp_example","created_at":1791015238,"model":"grok-4.7","output":[{"id":"item_reasoning","type":"reasoning","status":"in_progress","summary":[{"text":"The user wants a reply of exactly \"pong\".","type":"summary_text"}]},{"id":"item_message","type":"message","role":"assistant","content":[{"type":"output_text","text":"pong"}],"status":"completed"}],"status":"completed","usage":{"input_tokens":1248,"input_tokens_details":{"cached_tokens":1152},"output_tokens":55,"output_tokens_details":{"reasoning_tokens":54},"total_tokens":1303}},"output_index":0}会話の圧縮
POST https://llmoxy.com/v1/responses/compact項目は model(必須)、input、instructions、previous_response_id です。上記の grok 実測ではこのルートを呼んでいません。
