Responses API
POST https://llmoxy.com/v1/responses reçoit un corps JSON. En-têtes :
Authorization: Bearer <LLMOXY_API_KEY>
Content-Type: application/jsonLa 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.
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.
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
POST https://llmoxy.com/v1/responses/compactLes champs sont model (requis), input, instructions et previous_response_id. Les essais grok ci-dessus n'ont pas utilisé cette route.
