API MiniMax: primeira requisição em cinco minutos

Instale o SDK da OpenAI

Comece instalando o SDK oficial da OpenAI para sua linguagem preferida. A biblioteca cuida automaticamente do formato das requisições e do streaming. Certifique-se de ter Python 3.8+ ou Node.js 18+ instalados. Execute pip install openai para Python ou npm install openai para Node. O SDK simplifica a interação com o endpoint /v1/chat/completions. Ele gerencia cabeçalhos, novas tentativas e análise de SSE para que você possa focar no prompt. Isso funciona porque nossa API segue o padrão de chat completions da OpenAI. Você não precisa de uma biblioteca cliente personalizada. Os métodos padrão do SDK mapeiam diretamente para nossos endpoints. Isso reduz o tempo de integração e aproveita o conhecimento existente dos desenvolvedores.

Configure sua URL base e chave

Defina sua chave de API e URL base nas variáveis de ambiente. Nossa URL base é https://api.minimaxapikey.com/v1. Isso permite que você use clientes padrão da OpenAI sem modificações. Crie uma conta para gerar sua chave. A chave é exibida imediatamente após o cadastro. Nenhum cartão é necessário para o teste. Armazene a chave com segurança. Passe-a como cabeçalho ou variável de ambiente. O SDK usa OPENAI_API_KEY por padrão. Você pode substituir a URL base para apontar para nossos servidores. Isso garante que todas as requisições vão para o modelo sem censura. Verifique se sua chave funciona com um ping simples. Esta etapa evita erros de autenticação mais tarde.

Envie uma conclusão de chat básica

Faça sua primeira requisição para gerar texto. Use o método POST em /v1/chat/completions. Especifique o modelo como uncensored. Passe um array de mensagens com um prompt do usuário. A API retorna um token de conclusão. Esta é a funcionalidade principal de geração de texto. Suporta janela de contexto de 100k. Você pode enviar prompts longos ou histórico de conversas. A resposta inclui o texto gerado e o uso de tokens. Isso é ideal para escrita criativa ou diálogos sem restrições. Certifique-se de que o conteúdo seja legal. O modelo não recusa tópicos adultos. Ele apenas bloqueia conteúdo sexual envolvendo menores. Comece de forma simples para verificar a conectividade.

Ative o streaming (SSE)

Para saída em tempo real, ative o streaming. Defina o parâmetro stream como true. A API retorna Server-Sent Events (SSE). Cada chunk contém parte da resposta. Isso reduz a latência percebida. Os usuários veem o texto aparecer conforme é gerado. O SDK faz a análise de chunks automaticamente. Você pode exibir o texto incrementalmente em uma interface. Isso é crucial para interfaces de chat. O streaming funciona com todas as respostas do modelo. Não afeta a contagem de tokens. Cada chunk inclui dados de uso no final. Use isso para uma melhor experiência do usuário. Parece mais responsivo do que esperar pela resposta completa. Configure seu cliente para armazenar os chunks corretamente.

Use chamada de funções/ferramentas

Suporte a saídas estruturadas com chamada de funções. Defina ferramentas no corpo da requisição. O modelo pode chamar funções com base no prompt. Isso permite integração com sistemas externos. Passe definições de ferramentas e mensagens do usuário. A resposta inclui um objeto de chamada de ferramenta. Execute a função e envie os resultados de volta. Isso funciona com SDKs padrão da OpenAI. Permite fluxos de trabalho complexos. Você pode construir agentes ou assistentes. O modelo mantém o contexto entre chamadas. Isso é poderoso para automação. Certifique-se de que suas definições de ferramentas sejam precisas. A API gerencia o roteamento das saídas das ferramentas. Mantém a conversa coerente. Use isso para geração de conteúdo dinâmico.

Verifique os modelos disponíveis

Verifique a lista de modelos via GET /v1/models. Este endpoint retorna os modelos disponíveis. Nossa API oferece um único modelo: uncensored. É um modelo de pesos abertos. Não é GPT, Claude ou Gemini. A resposta confirma o ID do modelo. Use isso para depurar configurações do cliente. Certifique-se de que seu código aponte para o modelo correto. O endpoint é rápido e confiável. Retorna dados JSON. Você pode analisar isso para exibições na interface. Confirma se sua chave de API é válida. Use isso para verificações de saúde automatizadas. Faz parte do padrão OpenAI. Nenhuma configuração extra é necessária. Isso garante compatibilidade com ferramentas existentes.

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxapikey.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);

Streaming

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)