Introdução
A API MiniMax M3.1 Flash combina 1.000.000 de tokens de entrada com compreensão de imagens e video para agentes de código; reasoning_effort ajusta o raciocínio sem trocar de modelo. M3.1 Flash lê image_url e video_url junto ao texto e responde em texto; este endpoint não aceita áudio e o video precisa ser integrado dentro do limite conjunto de 14 MB da plataforma.
Recursos e destaques
M3.1 Flash sempre raciocina com low, medium, high, xhigh ou max, este último por padrão; aqui não há temperature nem top_p e none não é aceito. Reserve em max_tokens o raciocínio do M3.1 Flash e a resposta visível juntos: 4.096 por padrão e até 524.288; stop permite quatro sequências de até 32 caracteres. M3.1 Flash permite até 256 mensagens e 128 definições de ferramentas por solicitação; imagens consomem tokens de entrada e dividem o orçamento com a conversa.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
messages | Sim | Monte o histórico do M3.1 Flash em ordem, com mídia e trocas completas entre assistente e ferramentas; envie video integrado até 14 MB, sem partes de áudio neste endpoint. pelo menos 1 itens · no máximo 256 itens |
max_tokens | Não | Limite juntos o raciocínio e a resposta visível do M3.1 Flash: 4.096 inicialmente, no máximo 524.288; um orçamento pequeno pode acabar antes do texto. |
reasoning_effort | Não | No M3.1 Flash, escolha low, medium, high, xhigh ou max por padrão; o raciocínio continua ativo e maior esforço pode consumir mais tokens de saída e tempo. |
stop | Não | Encerre a resposta do M3.1 Flash em uma sequência correspondente, excluída do texto final; use uma string ou até quatro com no máximo 32 caracteres cada. pelo menos 1 caracteres · pelo menos 1 itens · no máximo 4 itens |
tools | Não | Ofereça ao M3.1 Flash até 128 definições de funções no formato OpenAI; detalhe o esquema dos argumentos, pois sua aplicação executa as funções. no máximo 128 itens |
parallel_tool_calls | Não | Permita que M3.1 Flash proponha chamadas independentes juntas e preserve cada identificador ao devolver os resultados de execução separados. Valor padrão: |
tool_choice | Não | Oriente a escolha de ferramentas do M3.1 Flash com auto, none, required ou uma função nomeada; none desativa essa seleção, não o raciocínio. |
response_format | Não | Peça texto ou JSON estruturado ao M3.1 Flash e valide o objeto antes de usá-lo como registro de diagnóstico ou entrada executável. |
Preços
Entrada $0.15 / Saída $0.60 por 1 milhão de tokens
Casos de uso
Este exemplo do M3.1 Flash pede as próximas chamadas de diagnóstico; confira se cada ação proposta parte das evidências do problema enviadas. Nos ciclos de ferramentas do M3.1 Flash, preserve a resposta completa do assistente, com raciocínio e chamadas, e devolva resultados com o tool_call_id correspondente; sua aplicação valida e executa as ações.
Guia de prompt e dicas práticas
M3.1 Flash mede entrada, entrada em cache e saída separadamente; imagens e video contam na entrada e o raciocínio usa o orçamento de saída, com tarifas atuais nesta página. A SpicyAPI não acrescenta filtro próprio ao M3.1 Flash; o modelo decide a resposta e nem mídia nem maior raciocínio garantem saída NSFW.
minimax/m3.1-flash/chat
Início rápido da API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "minimax/m3.1-flash/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
