# Responses API

> LLMoxy の POST /v1/responses リクエスト項目、既定の除去、grok-4.6 と grok-4.7 のストリーム実測。

`POST https://llmoxy.com/v1/responses` は JSON 本文を受け取ります。リクエストヘッダー：

```txt
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` にします。

```bash
curl https://llmoxy.com/v1/responses \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Reply with exactly: pong",
    "max_output_tokens": 64,
    "stream": true
  }'
```

応答の `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 はプレースホルダです。その他の項目は当回の応答と一致します。

```txt
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}
```

## 会話の圧縮

```txt
POST https://llmoxy.com/v1/responses/compact
```

項目は `model`（必須）、`input`、`instructions`、`previous_response_id` です。上記の grok 実測ではこのルートを呼んでいません。

これは https://jp.llmoxy.com/docs/api-reference/responses の markdown 版です。
