API | MiniMax M3.1 Flash API – Contexto 1M, vídeo

minimax/m3.1-flash/chat

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. 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.

Entrada $0.15Saída $0.60por 1 milhão de tokensEntrada em cache $0.015

Executar modelo Ver API

Enviar uma requisição

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações

POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições JSON.

Authorization: Bearer $SPICY_API_KEY

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'

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Use um Idempotency-Key para cada requisição lógica. Depois de uma interrupção de rede, não reenvie automaticamente com uma chave nova; guarde o request_id para investigar a requisição aceita. A idempotência não reproduz um stream de chat anterior.

Parâmetros de entrada

Coloque os parâmetros do modelo direto no corpo JSON da requisição, ao lado de model. Este endpoint não usa um objeto input.

messagesarray<object>Obrigatório

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.

Valor padrão: Não especificado
Restrições: minItems:1
maxItems:256

messages[].rolestringObrigatório no objeto

Role of the message author.

Valor padrão: Não especificado
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor padrão: Não especificado

messages[].contentstring | array | nullOpcional

Message content, either plain text or a list of content parts.

Valor padrão: Não especificado

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor padrão: Não especificado

messages[].tool_call_idstringOpcional

Identifier of the tool call this message answers. Required on tool messages.

Valor padrão: Não especificado

messages[].reasoning_contentstringOpcional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valor padrão: Não especificado

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOpcional

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.

Valor padrão: Não especificado

tool_choicestring | objectOpcional

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.

Valor padrão: Não especificado

parallel_tool_callsbooleanOpcional

Permita que M3.1 Flash proponha chamadas independentes juntas e preserve cada identificador ao devolver os resultados de execução separados.

Valor padrão: true

toolsarray<object>Opcional

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.

Valor padrão: Não especificado
Restrições: maxItems:128

stopstring | arrayOpcional

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.

Valor padrão: Não especificado
Restrições: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

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.

Valor padrão: "max"
Valores permitidos: "low""medium""high""xhigh""max"

max_tokensintegerOpcional

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.

Valor padrão: 4096
Restrições: minimum:1
maximum:524288

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "maxLength": 32,
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 524288,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "max",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 16384,
  "x-input-token-limit": 1000000,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Ler resultado

Com stream em false, a requisição já devolve a resposta completa: leia choices[].message, sem consultar tarefa nenhuma. Coloque stream em true se o seu cliente aceita Server-Sent Events.

Exemplo de resposta concluída

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "minimax/m3.1-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta resposta serve só para mostrar o formato. usage traz a contagem de tokens; o consumo e a cobrança reais dependem da sua requisição.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal e scripts de automação.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instruções reutilizáveis para seu assistente de IA.

n8n

Nós comunitários para instalações próprias e modelos importáveis com HTTP Request para n8n Cloud.

ComfyUI

Fluxos de imagem, vídeo e áudio em um canvas de nós.

Mais integrações

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar fluxos prontos para usar

É um modelo de chat, então funciona onde a API de chat da OpenAI funciona: mantenha seu cliente, troque a URL base e escolha este modelo pelo identificador.

Aponte qualquer cliente compatível com OpenAI para cá

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/minimax/m3.1-flash/chat

Qualquer ferramenta compatível com a API de chat da OpenAI funciona da mesma forma: SDKs, Vercel AI SDK, LangChain, aider e Cline. O servidor MCP e o CLI spicyapi atendem tarefas de mídia assíncronas. A configuração de cada ferramenta está no hub de desenvolvimento.

Use no SillyTavern e em apps de roleplay

No SillyTavern, RisuAI, Agnai ou qualquer app com configuração compatível com OpenAI, cole a URL base abaixo e sua chave de API e escolha minimax/m3.1-flash/chat como modelo. Chamadas direto do navegador são aceitas, e controles que este modelo não suporta são ignorados em vez de recusados.

Base URL: https://api.spicyapi.ai/v1
Model: minimax/m3.1-flash/chat

Guia do SillyTavern RisuAI, Agnai e outros Extensão do SillyTavern

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e escolha minimax/m3.1-flash/chat no nó SpicyAPI Chat para usar este modelo em um grafo do ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Exemplos de fluxos de trabalho Guia de configuração Código-fonte no GitHub

O painel incorporado lê o mesmo schema desta página, então não tem como sair de sincronia com a API. Se a sua documentação precisar de conteúdo indexável, pegue o JSON em /api/embed/models/ e renderize por conta própria.

<iframe src="https://spicyapi.ai/embed/pt-BR/models/minimax-m3-1-flash/api?model=minimax%2Fm3.1-flash%2Fchat" width="100%" height="560" loading="lazy" title="Exemplo de requisição" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir o painel

Playground

Enviar uma requisição

Autenticação da API

Parâmetros de entrada

Ler resultado

SDKs e integrações

Use no SillyTavern e em apps de roleplay

Use no ComfyUI