Início Rápido da API MiniMax M3 com Novita AI

O MiniMax M3 está disponível através da Novita AI com o ID de modelo minimax/minimax-m3, uma URL base compatível com OpenAI, uma janela de contexto de 1.000.000 tokens e preços em camadas para prompts mais longos. Este guia de início rápido mantém a configuração prática: copie o ID do modelo, defina sua chave de API, execute uma pequena solicitação e, em seguida, amplie para prompts mais longos depois que o básico funcionar.

Quando Usar Este Guia de Início Rápido

Use este guia de início rápido quando quiser testar o MiniMax M3 através de um caminho de API serverless, em vez de construir em torno da hospedagem bruta do modelo. É para desenvolvedores que já têm um prompt ou carga de trabalho em mente e precisam do endpoint, ID do modelo, limites de tokens e detalhes de preços antes de escrever uma pequena prova de conceito.

O MiniMax M3 é uma boa escolha quando sua solicitação precisa de um grande orçamento de contexto, saída estruturada, tarefas orientadas a ferramentas ou assistência de codificação em entradas longas. Na Novita AI, a página atual do modelo lista texto, imagem e vídeo como modalidades de entrada aceitas, texto como modalidade de saída e suporte para acesso serverless, chamada de função, saída estruturada, raciocínio e compatibilidade com a API Anthropic.

Este não é um mergulho profundo em benchmarks ou um anúncio de lançamento. O objetivo é mais simples: fazer uma solicitação limpa e, em seguida, decidir se o MiniMax M3 se encaixa na sua aplicação.

Passo 1: Obtenha Sua Chave de API da Novita

Crie ou selecione uma conta Novita AI, abra as configurações da sua chave de API e gere uma chave para uso no lado do servidor. Mantenha a chave fora do código do lado do cliente, bundles de frontend, repositórios públicos e notebooks que possam ser compartilhados fora da sua equipe.

Defina a chave como uma variável de ambiente antes de executar os exemplos:

export NOVITA_API_KEY="sua_chave_api_aqui"

Se estiver testando em um ambiente de equipe, use uma chave de projeto com escopo ou uma chave temporária, se sua configuração de conta suportar. Gire a chave após demonstrações públicas, experimentos compartilhados ou qualquer exposição acidental.

Passo 2: Confirme o ID do Modelo e o Endpoint

Antes de escrever código, mantenha os detalhes de conexão do MiniMax M3 em um só lugar:

Campo	Valor
ID do Modelo	minimax/minimax-m3
URL Base	https://api.novita.ai/openai
URL de Completions de Chat	https://api.novita.ai/openai/v1/chat/completions
Janela de Contexto	1.000.000 tokens
Saída Máxima	131.072 tokens
Entradas	Texto, imagem, vídeo
Saída	Texto
Suporte Serverless	Suportado
Chamada de Função	Suportado
Saída Estruturada	Suportado
Raciocínio	Suportado
Compatibilidade com API Anthropic	Suportado

Verifique a documentação do modelo MiniMax M3 antes de implantar, pois disponibilidade, preços e limites podem mudar.

Passo 3: Envie Sua Primeira Solicitação

Comece com uma solicitação de chat curta, apenas de texto. É muito mais fácil depurar autenticação, roteamento e análise de resposta antes de adicionar um prompt grande.

Para o primeiro prompt, peça uma saída determinística e fácil de verificar. Por exemplo: Resuma os principais riscos de implementação em um processo de revisão de código de contexto longo.

Mantenha max_tokens modesto para a primeira chamada. O MiniMax M3 suporta saída muito mais longa, mas o primeiro trabalho é confirmar que a integração funciona.

Passo 4: Leia a Resposta

Uma resposta de completions de chat compatível com OpenAI geralmente retorna a resposta do assistente em choices[0].message.content.

Também registre o ID da solicitação ou metadados de resposta que seu runtime expõe. Esses detalhes são úteis quando uma solicitação falha ou é lenta. Para rastreamento de custos, registre o tamanho do prompt, tamanho da saída, uso de leitura de cache se sua carga de trabalho usar contexto em cache e se a solicitação entrou na faixa de preço de contexto longo.

Não trate a primeira saída como prova de que seu prompt está pronto para usuários. Depois que a integração funcionar, teste prompts que se pareçam com sua carga de trabalho real: bases de código longas, instruções de vários arquivos, esquemas de ferramentas, saída JSON estruturada ou entradas multimodais, se sua aplicação precisar deles.

Passo 5: Verifique Preços, Limites e Erros Comuns

O MiniMax M3 usa preços em camadas na Novita AI. O preço muda quando o prompt entra na faixa de contexto longo:

Faixa de tamanho do prompt	Entrada	Saída	Leitura de cache
Menos de 524.288 tokens	US$ 0,30 por 1M de tokens	US$ 1,20 por 1M de tokens	US$ 0,06 por 1M de tokens
524.288 a 1.000.000 tokens	US$ 1,20 por 1M de tokens	US$ 4,80 por 1M de tokens	US$ 0,24 por 1M de tokens

Essa divisão é importante. Um teste de 50.000 tokens e uma solicitação de quase 1M de tokens não têm o mesmo preço. Ao estimar o custo, inclua o comprimento do prompt, o comprimento esperado da saída, o comportamento do cache, as repetições e a frequência com que os usuários podem enviar solicitações muito grandes.

Atualmente, o MiniMax M3 tem uma janela de contexto de 1.000.000 tokens e uma saída máxima de 131.072 tokens. Antes de implantar, verifique novamente a documentação do modelo MiniMax M3 para obter a tabela de preços mais recente e quaisquer diretrizes de limite de taxa associadas à sua conta.

Erros comuns de configuração incluem:

• Cabeçalho Authorization ausente ou malformado.
• Uso do ID de modelo errado, como um nome de exibição em vez de minimax/minimax-m3.
• Envio de solicitações para a URL base errada.
• Definição de max_tokens maior do que sua aplicação pode consumir com segurança.
• Teste de prompts de contexto longo sem considerar a faixa de preço mais alta.
• Passagem de conteúdo multimodal em um formato que sua biblioteca cliente não suporta.

Exemplo em Python

Este exemplo usa o SDK OpenAI Python com a URL base compatível com OpenAI da Novita AI.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai/v1",
)

response = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[
        {
            "role": "system",
            "content": "Você é um assistente de API conciso para equipes de software.",
        },
        {
            "role": "user",
            "content": "Resuma os principais riscos de implementação em um processo de revisão de código de contexto longo.",
        },
    ],
    temperature=0.2,
    max_tokens=600,
)

answer = response.choices[0].message.content
print(answer)

Envie a Solicitação com cURL

Se preferir cURL, mantenha o corpo JSON em uma variável payload. Isso torna a solicitação mais fácil de ler e evita amontoar o corpo JSON completo em um único comando.

payload='{
  "model": "minimax/minimax-m3",
  "messages": [
    {
      "role": "system",
      "content": "Você é um assistente de API conciso para equipes de software."
    },
    {
      "role": "user",
      "content": "Resuma os principais riscos de implementação em um processo de revisão de código de contexto longo."
    }
  ],
  "temperature": 0.2,
  "max_tokens": 600
}'

curl --request POST "https://api.novita.ai/openai/v1/chat/completions" \
  --header "Authorization: Bearer $NOVITA_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$payload"

Parâmetros Principais

Parâmetro	O que controla	Comece com
model	Qual modelo hospedado responde à solicitação	minimax/minimax-m3
messages	Instruções do sistema e do usuário	Um prompt curto, apenas de texto
temperature	Variabilidade da saída	0.2 para testes repetíveis
max_tokens	Saída máxima gerada	Um limite pequeno, depois aumente
stream	Se os tokens são transmitidos progressivamente	Ative depois que a chamada básica funcionar
tools	Definições de ferramentas/funções	Adicione uma ferramenta de cada vez
response_format	Forma da resposta estruturada	Valide a saída antes de usá-la

Para entradas multimodais, confirme o formato exato da solicitação em sua documentação do SDK ou API antes de confiar em prompts de imagem ou vídeo. A página do modelo lista suporte de modalidade, mas a formatação da solicitação depende do caminho do cliente que você usa.

Solução de Problemas

Falha na autenticação

Verifique se a variável NOVITA_API_KEY está definida no mesmo shell ou runtime onde você executa a solicitação. O cabeçalho de autorização deve usar o formato bearer-token.

A API não encontra o modelo

Confirme que a solicitação usa minimax/minimax-m3, não MiniMax M3, minimax-m3 ou um título de blog. Nomes de exibição de modelo e IDs de modelo não são intercambiáveis.

A solicitação funciona para prompts curtos, mas falha para prompts longos

Meça a entrada serializada, não apenas a contagem de palavras visível. Esquemas de ferramentas, documentos recuperados, referências de imagem e histórico de conversa contam. Se você estiver se aproximando de 1.000.000 tokens, tente um prompt menor e adicione lógica de truncamento ou recuperação antes de tentar novamente.

A conta está mais alta do que o esperado

Verifique se o prompt entrou na faixa de preço de 524.288 a 1.000.000 tokens. O MiniMax M3 tem preços mais altos de entrada, saída e leitura de cache nessa camada de contexto longo.

Saída estruturada inconsistente

Comece com um esquema menor, temperatura mais baixa e validação explícita. Se sua aplicação exigir JSON estrito, lide com respostas malformadas com validação e lógica de repetição, em vez de assumir que toda resposta será analisada.

Chamadas de ferramenta não correspondem ao seu esquema de função

Teste uma ferramenta de cada vez. Mantenha nomes de função, descrições e esquemas de parâmetros claros e adicione validação no lado do servidor antes de executar qualquer chamada de ferramenta.

FAQ

O MiniMax M3 está disponível através da API Novita AI?

Sim. A página atual do modelo Novita AI lista o MiniMax M3 como disponível através de acesso API serverless com o ID de modelo minimax/minimax-m3.

Qual é o ID do modelo para o MiniMax M3?

Use minimax/minimax-m3.

Qual URL base devo usar?

Use https://api.novita.ai/openai como a URL base compatível com OpenAI. Nos SDKs OpenAI, defina a URL base do SDK como https://api.novita.ai/openai/v1.

Quanto custa o MiniMax M3 na Novita AI?

O preço do MiniMax M3 é em camadas. Para prompts abaixo de 524.288 tokens, a entrada é US$ 0,30 por 1M de tokens, a saída é US$ 1,20 por 1M de tokens e a leitura de cache é US$ 0,06 por 1M de tokens. Para prompts de 524.288 a 1.000.000 tokens, a entrada é US$ 1,20 por 1M de tokens, a saída é US$ 4,80 por 1M de tokens e a leitura de cache é US$ 0,24 por 1M de tokens.

O MiniMax M3 suporta streaming ou entrada multimodal?

A página atual do modelo lista entradas de texto, imagem e vídeo com saída de texto. O comportamento de streaming deve ser testado através do caminho de completions de chat compatível com OpenAI antes do uso em produção.

Qual é a janela de contexto máxima?

Atualmente, o MiniMax M3 tem uma janela de contexto de 1.000.000 tokens e uma saída máxima de 131.072 tokens.