Responses API

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

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

ChampTypeRequisComportement
modelstringouiIdentifiant de modèle non vide.
inputstring ou arrayouiDoit ê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.
includeJSONnonConservé tel quel.
conversationJSONnonConservé tel quel.
context_managementJSONnonConservé tel quel.
instructionsJSONnonConservé tel quel. La forme courante est une chaîne.
max_output_tokensnumbernonNullable. Un 0 explicite est conservé.
top_logprobsnumbernonNullable. Un 0 explicite est conservé.
metadataJSONnonConservé tel quel.
parallel_tool_callsJSONnonConservé tel quel. Un false explicite est conservé.
previous_response_idstringnonUne chaîne vide est omise.
reasoning.effortstringnonUne chaîne vide est omise. La valeur n'est pas validée.
reasoning.summarystringnonUne chaîne vide est omise. La valeur n'est pas validée.
service_tierstringnonRetiré par défaut.
storeJSONnonConservé par défaut. Un false explicite est conservé.
prompt_cache_keyJSONnonConservé tel quel.
prompt_cache_retentionJSONnonConservé tel quel.
safety_identifierJSONnonRetiré par défaut.
streambooleannonL'absence signifie une requête non streamée. Un false explicite est conservé.
stream_options.include_usagebooleannonfalse est omis lors de la reconstruction.
stream_options.include_obfuscationbooleannonRetiré par défaut. false est omis lors de la reconstruction.
temperaturenumbernonNullable. Un 0 explicite est conservé.
textJSONnonConservé tel quel.
tool_choiceJSONnonConservé tel quel.
toolsJSONnonConservé tel quel.
top_pnumbernonNullable. Un 0 explicite est conservé.
truncationJSONnonConservé tel quel.
userJSONnonConservé tel quel.
max_tool_callsnumbernonNullable. Un 0 explicite est conservé.
promptJSONnonConservé tel quel.
enable_thinkingJSONnonConservé tel quel.
presetJSONnonConservé 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èleHTTPmodel de la réponsestatusTexteinput / output / total
grok-4.6200grok-4.6completedpong212 / 98 / 310
grok-4.7200grok-4.7completedpong1248 / 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.

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
  }'
BASH

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/compact

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