Família MiniMax

Os modelos de texto da MiniMax, incluindo MiniMax M3, M2.7 e M2.7 HighSpeed. São chamados pela API compatível com OpenAI e também suportam o endpoint nativo da Anthropic, podendo ser usados no Claude Code. Os modelos de vídeo da MiniMax estão em Hailuo (MiniMax).

Tarefas comuns

Modelos

A lista completa de modelos e os preços atualizados estão na página de modelos . O prefixo dos IDs de modelo é minimax/ e pode ser omitido; usar o nome oficial MiniMax-M3 retorna 404.

Esses modelos são oferecidos pela MiniMax oficial (minimax) e suportam os endpoints Chat Completions, Responses e o nativo da Anthropic.

Exemplos de chamada

import os
import re
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "Explique em uma frase o que é idempotência."}],
)
content = resp.choices[0].message.content
answer = re.sub(r"<think>.*?</think>\s*", "", content, flags=re.S)
print(answer)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-m3",
    "messages": [{"role": "user", "content": "Explique em uma frase o que é idempotência."}]
  }'

Conteúdo do thinking

Os modelos MiniMax vêm com thinking ativado por padrão. No endpoint compatível com OpenAI, message.content começa com o conteúdo do thinking envolto em <think>…</think>, e só depois vem a resposta; no streaming, o mesmo ocorre em delta.content. O exemplo acima remove esse trecho com uma expressão regular.

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "Um número somado ao seu triplo, menos 12, é igual a 36. Que número é esse? Responda só com o número."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

• No MiniMax M3, thinking.type aceita apenas adaptive e disabled; enviar enabled retorna 400.
• Os tokens de thinking contam em max_tokens. Se o limite for muito baixo, a resposta pode parar no meio do thinking, com finish_reason igual a length.
• Os tokens de thinking são cobrados pelo preço de saída, e a quantidade aparece em usage.completion_tokens_details.reasoning_tokens.

Usar no Claude Code

Os modelos MiniMax suportam o endpoint nativo da Anthropic, no endereço https://api.ofox.ai/anthropic. Por esse endpoint, o conteúdo do thinking é retornado em blocos thinking separados, e a resposta fica nos blocos text, sem necessidade de remover as tags think manualmente.

import os
import anthropic
 
client = anthropic.Anthropic(base_url="https://api.ofox.ai/anthropic", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.messages.create(
    model="minimax/minimax-m2.7",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Um número somado ao seu triplo, menos 12, é igual a 36. Que número é esse?"}],
)
for block in resp.content:
    print(block.type, ":", getattr(block, "thinking", None) or block.text)

• MiniMax M2.7 e M2.7 HighSpeed sempre retornam blocos thinking.
• O MiniMax M3 retorna blocos thinking quando recebe "thinking": {"type": "adaptive"} ou {"type": "enabled", "budget_tokens": 2000}, e apenas blocos text quando recebe {"type": "disabled"}.

Os passos completos de configuração do Claude Code estão em Configuração do Claude Code.

Entrada de imagem

Somente o MiniMax M3 aceita entrada de imagem, pelo bloco de conteúdo padrão image_url; o formato está em Visão. MiniMax M2.7 e M2.7 HighSpeed aceitam somente texto; para reconhecer imagens, use o M3.

Outros recursos

• Chamada de ferramentas: usa o parâmetro padrão tools e retorna tool_calls.
• Cache: os prefixos de requisição repetidos são armazenados em cache automaticamente, e a quantidade em cache aparece em usage.prompt_tokens_details.cached_tokens. Em nossos testes, com um prefixo idêntico de cerca de 5600 tokens, a segunda requisição teve mais de 5000 tokens em cache.
• Saída estruturada: em nossos testes, mesmo enviando json_schema em response_format, a resposta continuou em texto comum. Quando precisar de JSON, descreva os campos no prompt e faça o parse por conta própria.

Erros comuns

Outros erros gerais estão em Tratamento de erros.

Documentação oficial

• Plataforma aberta da MiniMax · Documentação 

Perguntas frequentes