Schemas
Model
A model ID from the current catalog — real provider model names, all MiniMax. The core tiers are minimax-m3 (flagship), minimax-m2.7 (balanced daily driver) and minimax-m2.5 (fast); the -highspeed variants are latency-tuned versions of their standard siblings at roughly 2x the price; minimax-m2.1 and minimax-m2 are older M-series generations; minimax-m2-her is role-play/dialogue chat tuning; minimax-text-01 is the long-context text model. There are no invented aliases; any other ID returns an error. The catalog can change with notice.
ChatMessage
roleWho authored this message. system sets behavior, user asks, assistant answers (or requests tool calls), tool returns a tool result.
contentThe message text. May be null on an assistant message that only carries tool_calls.
nameOptional participant name to disambiguate same-role messages.
Tool calls requested by the assistant (assistant messages only).
tool_call_idRequired when role is tool — the id of the tool call this message responds to.
Tool
typeOnly function tools are supported.
ToolCall
idIdentifier to echo back in the tool role reply as tool_call_id.
typeChatCompletionRequest
modelA model ID from the current catalog — real provider model names, all MiniMax. The core tiers are minimax-m3 (flagship), minimax-m2.7 (balanced daily driver) and minimax-m2.5 (fast); the -highspeed variants are latency-tuned versions of their standard siblings at roughly 2x the price; minimax-m2.1 and minimax-m2 are older M-series generations; minimax-m2-her is role-play/dialogue chat tuning; minimax-text-01 is the long-context text model. There are no invented aliases; any other ID returns an error. The catalog can change with notice.
The conversation so far — an array of role/content messages, oldest first.
max_tokensMaximum number of tokens to generate in the completion.
temperatureSampling temperature. Lower is more deterministic, higher is more creative. Alter this or top_p, not both.
top_pNucleus sampling — only tokens in the top top_p probability mass are considered. Alter this or temperature, not both.
nNumber of completion choices to generate per request.
streamSet true for a Server-Sent Events stream of deltas.
Up to 4 sequences where generation stops (string or array).
frequency_penaltyPenalize tokens by how often they already appeared — positive values reduce verbatim repetition.
presence_penaltyPenalize tokens that appeared at all — positive values push toward new topics.
Function tools the model may call. Supported — the gateway passes tool definitions and tool-call turns through to the upstream model.
Controls tool use. auto (the default) and none are honoured by the M-series. required and the named-function object are accepted by the API but ignored by the model, which decides for itself. Tested 2026-07-26. Design for a model that chooses, and always handle a turn with no tool call.
ChatCompletionResponse
idobjectcreatedUnix timestamp (seconds).
modelThe model that actually served the request. During a provider incident this may be a smaller model of the same family as the one you requested.
One entry per requested choice (n).
Token usage in Chat Completions shape.
ResponsesRequest
modelA model ID from the current catalog — real provider model names, all MiniMax. The core tiers are minimax-m3 (flagship), minimax-m2.7 (balanced daily driver) and minimax-m2.5 (fast); the -highspeed variants are latency-tuned versions of their standard siblings at roughly 2x the price; minimax-m2.1 and minimax-m2 are older M-series generations; minimax-m2-her is role-play/dialogue chat tuning; minimax-text-01 is the long-context text model. There are no invented aliases; any other ID returns an error. The catalog can change with notice.
The input — a plain string, or a list of typed input items (e.g. {"role": "user", "content": "..."}).
instructionsSystem-style instructions for the model.
max_output_tokensMaximum number of tokens to generate in the response.
streamSet true for a Server-Sent Events stream of response events.
ResponsesResponse
idobjectmodelThe model that actually served the request. During a provider incident this may be a smaller model of the same family as the one you requested.
statuscompleted, incomplete, or failed.
Output items — for text generation, one assistant message.
Token usage in Responses-API shape.
ResponsesUsage
input_tokensoutput_tokenstotal_tokensMessagesRequest
modelA model ID from the current catalog — real provider model names, all MiniMax. The core tiers are minimax-m3 (flagship), minimax-m2.7 (balanced daily driver) and minimax-m2.5 (fast); the -highspeed variants are latency-tuned versions of their standard siblings at roughly 2x the price; minimax-m2.1 and minimax-m2 are older M-series generations; minimax-m2-her is role-play/dialogue chat tuning; minimax-text-01 is the long-context text model. There are no invented aliases; any other ID returns an error. The catalog can change with notice.
max_tokensMaximum number of tokens to generate. Required by the Anthropic Messages format.
Alternating user / assistant turns, oldest first.
systemOptional system prompt — a top-level field here, not a message role.
temperatureSampling temperature, 0–1 in the Anthropic format. Lower is more deterministic.
streamSet true for a Server-Sent Events stream of message events.
stop_sequencesCustom sequences that stop generation.
MessagesResponse
idtyperolemodelThe model that actually served the request. During a provider incident this may be a smaller model of the same family as the one you requested.
Content blocks — for text generation, one text block.
stop_reasonend_turn, max_tokens, or stop_sequence.
stop_sequenceWhich stop_sequences entry matched, if any.