MiniMax api: Guia de Início Rápido e SDK

Autenticação e URL Base

Use a chave de API fornecida e aponte seu cliente para o URL base dedicado. O endpoint para gerar respostas é https://api.minimaxaiapi.com/v1/chat/completions. Você passa a chave no Authorization cabeçalho como um token bearer. Isso funciona com qualquer SDK padrão da OpenAI porque seguimos o mesmo protocolo.

• Nome do cabeçalho: Authorization
• Valor do cabeçalho: Bearer YOUR_API_KEY
• URL Base: https://api.minimaxaiapi.com/v1

Não é necessária configuração complexa. Basta atualizar a configuração em seu projeto existente.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Endpoint Chat Completions

Envie uma solicitação POST para o endpoint de conclusões de chat para obter uma resposta de texto. O identificador do modelo é uncensored. Você deve incluir uma matriz de mensagens com o histórico de sua conversa. O sistema processa a entrada e retorna o texto gerado com base no seu prompt.

Este endpoint lida com toda a geração de texto. Não suporta embeddings, áudio ou vídeo. Você pode transmitir respostas ou aguardar o bloco completo. O modelo lida com um contexto de até 100.000 tokens no total.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Streaming e Uso de Tokens

Ative o streaming definindo stream: true na sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) para cada token gerado. Isso permite a exibição em tempo real da saída. As estatísticas de uso de tokens estão incluídas no último fragmento do fluxo. Isso ajuda você a rastrear os custos com precisão sem analisar cada token individualmente.

O streaming reduz a latência percebida para respostas longas. É ideal para interfaces de chat e geração de conteúdo dinâmico. Você pode interromper o fluxo antecipadamente se o usuário interromper a geração.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Chamada de Função e Modo JSON

Use o tools parâmetro para habilitar chamada de função. Defina suas funções no corpo da solicitação e deixe o modelo escolher qual chamar. O tool_choice parâmetro permite forçar uma função específica ou auto-selecionar. Para saída JSON estrita, defina response_format para {"type": "json_object"}. Isso garante que a resposta seja JSON válido.

Chamada de função é útil para extrair dados estruturados ou acionar ações. O modo JSON é perfeito para integrações de API que exigem formatos previsíveis. Combine ambos para lógica de aplicativo robusta.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Parâmetros e Restrições do Modelo

Ajuste o comportamento de geração usando parâmetros padrão como temperature, top_p, e stop. A janela de contexto máxima é de 100.000 tokens, incluindo o prompt e a conclusão. A saída máxima por requisição é de 16.000 tokens. Se você não definir max_tokens, o limite padrão é 2.048 tokens.

Usar seed para resultados reproduzíveis. Defina presence_penalty e frequency_penalty para controlar a repetição. Esses parâmetros dão a você controle fino sobre a criatividade e consistência do modelo. Sempre teste com seu caso de uso específico para encontrar o equilíbrio certo.

Limites de Taxa e Erros

A API limita a 300 requisições por minuto e permite oito requisições simultâneas por chave. Se você exceder esses limites, receberá um erro 429. Um erro 401 indica uma chave de API inválida ou ausente. Um erro 402 significa que seu crédito pré-pago está esgotado.

Erros não consomem seu crédito. Você pode repetir solicitações falhas sem penalidade. O tamanho do corpo da solicitação é limitado a 8 MB. Gerencie sua concorrência cuidadosamente para evitar limitação. Monitore seu uso através do último fragmento de respostas em streaming.