MiniMax M3.1 Flash

Use exatamente o ID de modelo MiniMax-M3.1-Flash. A página do modelo oferece o Playground e os preços em tempo real. A especificação OpenAPI define os campos aninhados de requisição e resposta.

Início rápido

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

Este exemplo define um limite de saída; ele não é o padrão do modelo. Mantenha as chaves no seu servidor. O Playground usa a conta em que você está conectado e não exige que você cole uma chave de API.

Formatos e autenticação

Envie Content-Type: application/json e Authorization: Bearer $SEEDROUTER_API_KEY. Messages também aceita x-api-key; clientes SDK podem incluir anthropic-version: 2023-06-01. Esses formatos preservam seus corpos de requisição e estruturas de resposta nativos.

Parâmetros

Todos os campos são opcionais, exceto os obrigatórios indicados acima. Omitir um campo é diferente de enviar null explicitamente: um campo só aceita null quando a OpenAPI declara essa possibilidade. Campos de nível superior não suportados são descartados; valores inválidos em campos suportados retornam um erro.

Chat Completions

Messages

Responses

O Playground fixa model e disponibiliza todos os demais campos: 12 controles para Chat, 11 para Messages e 12 para Responses. Objetos aninhados e históricos completos de conversa usam campos JSON. Valores inválidos em campos suportados bloqueiam o envio no navegador.

Raciocínio e limites

A janela de contexto documentada é de 1.000.000 de tokens. O limite de saída é de 524.288 tokens, incluindo o raciocínio. A MiniMax recomenda 131.072 tokens de saída para tarefas exigentes, mas não define esse valor como padrão.

O modo de pensamento fica sempre ativado. Este modelo não suporta disabled, none e minimal como configurações de pensamento. Um orçamento de saída pequeno pode se esgotar antes que o texto da resposta apareça. Este contrato de API não suporta service_tier, entrada de áudio e saída JSON estruturada.

O corpo completo da requisição não pode ultrapassar 64 MB. O serviço do modelo valida o uso exato do contexto e o conteúdo das mídias remotas.

Imagens e vídeos

Chat usa os blocos de conteúdo image_url: {"url":"..."} e video_url: {"url":"..."}. Messages usa blocos de imagem/vídeo com um objeto source: {"type":"url","url":"..."} ou {"type":"base64","media_type":"...","data":"..."}. Responses usa input_image ou input_video, cujo valor de URL pode ser uma string ou um objeto de opções suportado.

detail aceita low, default e high, com default como padrão. O fps do vídeo varia de 0.2 a 5, com padrão 1. O campo opcional max_long_side_pixel é um inteiro positivo quando está disponível no esquema aninhado.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

Substitua a URL de exemplo pela de um arquivo seu que esteja acessível. Entradas inline usam o tipo MIME base64 apropriado; MOV usa video/mov. Referências de vídeo mm_file:// existentes são repassadas sem alterações, mas este serviço não oferece uma API de upload Files. A referência ainda precisa estar acessível à conta que processa a requisição.

Ferramentas e histórico de conversa

Ferramentas de função descrevem ações que sua aplicação pode executar. Uma chamada de ferramenta não comprova que uma ação externa foi executada: confira o nome e os argumentos, execute a ação na sua aplicação e depois retorne o resultado com o ID de chamada correspondente.

Ao continuar uma conversa com Chat, preserve a mensagem assistant completa, incluindo reasoning_content e tool_calls; mensagens de ferramenta exigem tool_call_id. Com Messages, preserve os blocos de pensamento, as assinaturas e os blocos tool_use e tool_result. Com Responses, acrescente todos os itens de saída retornados antes da próxima entrada do usuário.

Não reduza esses históricos ao texto das respostas. Esquemas arbitrários de parâmetros de função e campos de raciocínio devolvidos são preservados. A referência oficial de Chat não define um parâmetro tool_choice para este modelo.

Streaming e campos de resposta

Defina stream: true para receber eventos enviados pelo servidor. Chat emite choices[].delta e termina com [DONE]; solicite stream_options: {"include_usage":true} para receber os dados de uso. Messages emite eventos nomeados, como message_start, atualizações de blocos de conteúdo e message_stop. Responses emite eventos como response.output_text.delta e response.completed.

Sem streaming, Chat retorna choices[].message, finish_reason e usage. Messages retorna blocos de conteúdo, stop_reason e dados de uso. Responses retorna itens output, status e dados de uso. Preserve a resposta completa quando sua aplicação precisar de mais informações do que a resposta exibida.

Uso e preços atuais

A tabela de preços em tempo real mostra as duas faixas de entrada. Um total de entrada de até 512.000 tokens usa a primeira faixa; acima de 512.000, aplica-se a segunda. A faixa selecionada determina o preço de toda a requisição, incluindo saída e cache.

Tokens de leitura e gravação de cache não são cobrados novamente como entrada comum. O cache automático verifica prefixos repetidos elegíveis com pelo menos 512 tokens; não há garantia de acerto de cache. Não é necessário um marcador de cache explícito.

As respostas apresentam contagens de tokens, não valores monetários. Os registros de uso da conta mostram as cobranças finais. Requisições que falham não são cobradas.

Erros

Em caso de erro, confira o campo inválido e a referência pública de erros. O mesmo ID de modelo suporta os três endpoints de texto acima; ele não deve ser usado em um endpoint de embeddings ou do Gemini.

Referências oficiais

• Invocação de modelos MiniMax
• Referência de Chat Completions
• Referência de Messages
• Referência de Responses
• Continuação após chamadas de função
• Cache automático de prompts