Also answers at /models/completions. An OpenAI SDK works unchanged with its base URL set to the /v1 address and a Momor key. A call routes exactly as one sent to POST /models does: the same offerings, keys, failover and record.
An OpenAI offering is called on OpenAI’s own Chat Completions API through this route, and on OpenAI’s Responses API through POST /models, which is what carries reasoning blocks and their summaries back in Momor’s reply. Each route adds only a few milliseconds over calling that API directly, but OpenAI’s Responses API itself starts answering later than its Chat Completions API, so the first token of an OpenAI call arrives sooner through /v1/chat/completions.
Headers
- AuthorizationstringRequired
- Bearer and your API key. A signed-in Momor session works too.
- Content-TypestringRequired
- application/json. Anything else is refused with 415.
Body
Momor reads four fields, to route the call. Everything else goes to the provider as you wrote it, but for what Momor changes on the way, and is not checked: a field, message or part a provider does not take is that provider’s to answer.
- modelstring | string[]
- Momor reads it. A selector, such as anthropic/claude-sonnet-5, tier/high or auto, or several. Required unless models names one.
- modelsstring | string[]
- Momor reads it. Further selectors, tried in order after every one in model.
- providerobject
- Momor reads it. Which providers lead, which serve nothing on this call, how tied offerings are ordered, whether it runs under zero data retention, whether deprecated models may serve it and how old a model may be. A value Momor cannot read is refused with 400; any other option is ignored.
- orderstring[]
- Providers that lead, in this order, ahead of price: a root such as azure, or a region as name@region, such as azure@eu.
- ignorestring[]
- Providers that serve nothing on this call. A root leaves out the root alone; name@region leaves out that region alone.
- sortstringDefault
price - How offerings the order leaves tied are ordered. price, the cheapest first, is the only order Momor offers.
- zdrbooleanDefault
false - Run the call under zero data retention: only on saved keys marked zdr and on Momor’s keys its own agreements cover. Anything but true or false is refused with 400. Where your organization holds every call to it, false here does not turn it off.
- deprecatedboolean
- Let deprecated models serve a tier, auto or * selector. Left out, your organization’s default, else false. A selector naming one exact model is served by it either way.
- maxAgestring
- How old a model may be, as ISO 8601 such as P6M, P1Y or P2Y, or a TimeSpan such as 180.00:00:00: a tier, auto or * selector is served only by models released no longer ago than this. A month counts thirty days and a year 365. Left out, your organization’s default, else no model is left out for its age. A selector naming one exact model is served by it whatever its age.
- streambooleanDefault
false - Momor reads it. Send the reply as server-sent events. Anything but true or false is refused with 400.
- messagesobject[]
- The conversation, in Chat Completions’ shape. Passed to the provider.
- max_tokensinteger
- The output ceiling, as is max_completion_tokens; both go as one, as described under What Momor changes on the way. Anthropic requires one of them.
- toolsobject[]
- Passed to the provider. A call with tools is tried first on the offerings that take them; the others stay behind them as backup.
- response_formatobject
- Passed to the provider. A json_schema format is tried first on the offerings that take one.
- stream_optionsobject
- Passed to the provider. include_usage asks for a usage chunk at the end of a stream.
A body that is not a JSON object, a call that names no model, and a routing field that can’t be read or names a provider this deployment does not serve are refused with 400 invalid_value.
Response
A provider that speaks Chat Completions answers in its own words: its fields, logprobs and choices included, come back as it wrote them, with id and model written over and its reasoning as reasoning. An answer from Anthropic, Gemini or Vertex is translated into this shape.
- idstring
- The call’s id, the same as X-Momor-Request-Id. Use it with Get a generation.
- objectstring
- chat.completion
- createdinteger
- When the answer was made, in Unix seconds.
- modelstring
- The id of the model that served the call, publisher/name in lowercase.
- choicesobject[]
- The answers. Anthropic answers with one; Gemini with as many as n asks for.
- indexinteger
- The choice’s position.
- messageobject
- The assistant’s turn.
- rolestring
- assistant
- contentstring | null
- The answer, or null for a turn that only called tools.
- reasoningstring
- The text of the model’s reasoning.
- reasoning_detailsobject[]
- Each reasoning block, with the provider state it is replayed with in data. Keep it in the message you send back.
- tool_callsobject[]
- Each call whole, with its arguments as a JSON string. A Gemini call carries its signature in extra_content.google.thought_signature.
- logprobsobject | null
- The log probability of each token and its alternatives, where logprobs asked and the provider returned them.
- finish_reasonstring
- Why the answer ended.
stoplengthtool_callscontent_filter
- usageobject
- Tokens, as the provider reported them.
- prompt_tokensinteger
- Input, cache reads and cache writes together. prompt_tokens_details.cached_tokens is the cache reads.
- completion_tokensinteger
- Output, separately billed reasoning included. completion_tokens_details.reasoning_tokens is the reasoning within it.
- total_tokensinteger
- The two together.
- system_fingerprintstring
- The backend that served the call, where the provider names one.
Who served the call, every attempt and what each cost are on the call record: read it with Get a generation.
Response headers
- X-Momor-Request-Idstring
- The call’s id. Sent on every answer the route gives, a routing refusal included.
- X-Momor-Providerstring
- On a stream: the provider answering.
- X-Momor-Modelstring
- On a stream: the id of the model answering.
- X-RateLimit-Limitinteger
- The requests allowed in the window. See Rate limits, with X-RateLimit-Remaining and X-RateLimit-Reset.
Streaming
With stream set, the answer starts once a model has something to show, with X-Momor-Provider and X-Momor-Model naming who serves it. A failure before then is an HTTP error, so the SDK raises it as one, and routing may still move to another model.
A provider that speaks Chat Completions streams its own chunks, each with id and model written over and its reasoning as delta.reasoning. A translated stream’s first chunk names the assistant; text arrives as delta.content, reasoning as delta.reasoning and then as one delta.reasoning_details entry once a block ends. The last choice chunk carries finish_reason, a chunk with empty choices carries usage where stream_options.include_usage asked for it, and data: [DONE] ends the stream.
A failure after output ends the stream on one error chunk, with no [DONE]. A Chat Completions stream never moves to another provider once output has begun.
data: {"id":"4bf92f3577b34da6a3ce929d0e0e4736","object":"chat.completion.chunk","created":1759400000,"model":"anthropic/claude-sonnet-5","provider":"Anthropic","error":{"code":502,"message":"The provider closed the connection mid-answer."},"choices":[{"index":0,"delta":{"content":""},"finish_reason":"error"}]}Errors
Every failure is OpenAI’s error object, { "error": { "message", "type", "param", "code" } }, with param null unless the provider’s own error object names one.
Translated providers
Anthropic, Gemini and Vertex do not speak Chat Completions. A call routed to one of them is translated into its own API, and its answer is written back in Chat Completions’ shape. A field its API has no counterpart for is left off; content it has no way to carry, such as audio sent to Anthropic, fails that offering, and the call moves to the next candidate.
Send an assistant message back as you received it. Its reasoning_details carry the state Anthropic and Gemini check on replay.
What Momor changes on the way
- model becomes the provider’s own id for the offering, and models and provider are taken off.
- A stream always asks for usage with stream_options.include_usage, so the call can be recorded; you receive the usage chunk only where you asked for it. A provider that takes no stream_options, such as Mistral, is sent none.
- max_completion_tokens and max_tokens go as one ceiling, under the name the provider reads: OpenAI reads max_completion_tokens, and Mistral and DeepInfra read max_tokens. Where you send both, max_completion_tokens is the one that goes.
- seed goes under the name the provider reads: Mistral reads it as random_seed.
- reasoning_effort goes as a depth the model takes: the one you sent where the model takes it, otherwise the nearest deeper one it takes.
- On Momor’s key OpenAI keeps nothing: store goes to OpenAI as false, whatever you sent. On your own key, store goes as you wrote it.
- Reasoning you send back moves into the field that provider reads, and reasoning a provider answers with comes back as reasoning. Reasoning a model writes inside its answer as a <think> element stays in content.