# Responses API

> Champs de POST /v1/responses sur LLMoxy, filtrage par défaut, et essai en flux de grok-4.6 et grok-4.7.

`POST https://llmoxy.com/v1/responses` reçoit un corps JSON. En-têtes :

```txt
Authorization: Bearer <LLMOXY_API_KEY>
Content-Type: application/json
```

La passerelle analyse le corps selon une structure fixe. La requête est refusée si `model` est vide, si `input` est absent, ou si `max_output_tokens` est supérieur à 1 073 741 823. `background` ne fait pas partie de cette structure.

Sans transmission intégrale du corps, seuls les champs du tableau sont conservés. `service_tier`, `safety_identifier` et `stream_options.include_obfuscation` sont retirés par défaut. `store` est conservé. Un `0` explicite sur un nombre nullable et un `false` explicite sur `stream` sont envoyés. Un booléen `false` dans `stream_options` est omis lors de la reconstruction. Les champs hors tableau ne sont pas envoyés.

## Champs de la requête

| Champ | Type | Requis | Comportement |
| --- | --- | --- | --- |
| `model` | string | oui | Identifiant de modèle non vide. |
| `input` | string ou array | oui | Doit être présent. Une chaîne compte comme un texte d'entrée. Les éléments du tableau peuvent avoir `role`. Un `content` chaîne compte comme du texte. Un `content` tableau reconnaît `input_text`, `input_image` et `input_file`. `image_url` et `file_url` peuvent être une chaîne ou un objet avec `url`. |
| `include` | JSON | non | Conservé tel quel. |
| `conversation` | JSON | non | Conservé tel quel. |
| `context_management` | JSON | non | Conservé tel quel. |
| `instructions` | JSON | non | Conservé tel quel. La forme courante est une chaîne. |
| `max_output_tokens` | number | non | Nullable. Un `0` explicite est conservé. |
| `top_logprobs` | number | non | Nullable. Un `0` explicite est conservé. |
| `metadata` | JSON | non | Conservé tel quel. |
| `parallel_tool_calls` | JSON | non | Conservé tel quel. Un `false` explicite est conservé. |
| `previous_response_id` | string | non | Une chaîne vide est omise. |
| `reasoning.effort` | string | non | Une chaîne vide est omise. La valeur n'est pas validée. |
| `reasoning.summary` | string | non | Une chaîne vide est omise. La valeur n'est pas validée. |
| `service_tier` | string | non | Retiré par défaut. |
| `store` | JSON | non | Conservé par défaut. Un `false` explicite est conservé. |
| `prompt_cache_key` | JSON | non | Conservé tel quel. |
| `prompt_cache_retention` | JSON | non | Conservé tel quel. |
| `safety_identifier` | JSON | non | Retiré par défaut. |
| `stream` | boolean | non | L'absence signifie une requête non streamée. Un `false` explicite est conservé. |
| `stream_options.include_usage` | boolean | non | `false` est omis lors de la reconstruction. |
| `stream_options.include_obfuscation` | boolean | non | Retiré par défaut. `false` est omis lors de la reconstruction. |
| `temperature` | number | non | Nullable. Un `0` explicite est conservé. |
| `text` | JSON | non | Conservé tel quel. |
| `tool_choice` | JSON | non | Conservé tel quel. |
| `tools` | JSON | non | Conservé tel quel. |
| `top_p` | number | non | Nullable. Un `0` explicite est conservé. |
| `truncation` | JSON | non | Conservé tel quel. |
| `user` | JSON | non | Conservé tel quel. |
| `max_tool_calls` | number | non | Nullable. Un `0` explicite est conservé. |
| `prompt` | JSON | non | Conservé tel quel. |
| `enable_thinking` | JSON | non | Conservé tel quel. |
| `preset` | JSON | non | Conservé tel quel. |

## grok-4.6 et grok-4.7

Le 2026-10-03, les appels en flux vers `https://llmoxy.com/v1/responses` pour `grok-4.6` et `grok-4.7` ont tous deux renvoyé HTTP 200 et la même suite d'événements.

| Modèle | HTTP | `model` de la réponse | `status` | Texte | 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 |

Pour `grok-4.6`, `input_tokens_details.cached_tokens` valait 128 et `output_tokens_details.reasoning_tokens` valait 97. Pour `grok-4.7`, ces valeurs étaient 1152 et 54.

Le texte visible est l'élément `output` dont `type` vaut `message`, puis l'entrée `content` dont `type` vaut `output_text`, champ `text`. Les deux modèles émettent d'abord un élément `type` `reasoning`. Dans `response.completed`, cet élément a encore `status` `in_progress`.

Les requêtes de ces deux modèles transmettent le corps tel quel. Le JSON minimal de la section suivante est donc envoyé comme le client l'a écrit.

## Requête minimale réussie

Pour `grok-4.6`, utilisez le même corps et mettez `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
  }'
```

Le `Content-Type` de la réponse est `text/event-stream`. Chaque événement est une ligne `event:` et une ligne `data:`. La passerelle transmet le JSON d'origine de chaque événement analysé, et le nom d'événement est le `type` JSON. Le flux se termine par le dernier `response.completed`.

Les deux modèles émettent les mêmes noms, dans cet ordre :

`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`.

La capture ci-dessous est la réponse `grok-4.7`. Les identifiants de réponse et d'élément sont des marqueurs. Les autres champs correspondent à cette réponse.

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

## Compression de conversation

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

Les champs sont `model` (requis), `input`, `instructions` et `previous_response_id`. Les essais grok ci-dessus n'ont pas utilisé cette route.

Ceci est la version markdown de https://fr.llmoxy.com/docs/api-reference/responses.
