PT ▾

Configuração da API MiniMax: chave, URL base e primeira requisição

Configuração passo a passo da API compatível com OpenAI na minimaxapikey.com: conta, chave, URL base, primeira requisição. É um serviço independente, não a API oficial de nenhum fornecedor de modelo.

Atualizado

Seis etapas brilhantes levando de uma chave a um rack de servidores, representando o caminho de configuração da API

Pontos principais

  • Cadastre-se com Google ou e-mail, depois resgate $0,50 de crédito de teste na página da chave. Sem necessidade de cartão.
  • URL base é https://api.minimaxapikey.com/v1, ID do modelo é uncensored, autenticação é uma chave Bearer.
  • Existem dois métodos: POST /v1/chat/completions e GET /v1/models.
  • 401 significa chave inválida, e 429 significa limite atingido, então verifique o código de erro no corpo.

O que você está configurando

As pessoas buscam configuração da API minimax esperando uma de duas coisas: a plataforma oficial de desenvolvedores MiniMax, ou um endpoint estilo OpenAI pronto para usar. Esta página cobre o segundo. O serviço por trás da minimaxapikey.com é uma API de texto hospedada e compatível com OpenAI, executando um único modelo de pesos abertos, operada por um provedor independente. Não é a API oficial da MiniMax ou de qualquer outro fornecedor de modelo, e não roteia requisições entre fornecedores. Se precisar da plataforma do fornecedor, use o site deles.

O que você recebe é simples. Qualquer SDK ou cliente OpenAI funciona assim que você altera a URL base e a chave. Há dois métodos, POST /v1/chat/completions e GET /v1/models, um ID de modelo, uncensored, e uma janela de contexto de 100.000 tokens compartilhada por prompt e resposta. Suporta apenas texto, sem geração de imagem, áudio ou vídeo, sem embeddings e sem fine-tuning. Streaming, chamada de funções e modo JSON são suportados.

A configuração inteira leva alguns minutos. As etapas abaixo seguem em ordem, e cada uma termina com uma verificação para você saber que funcionou antes de prosseguir.

Etapas 1 e 2: criar uma conta e resgatar o teste

  1. Abra a página da chave. Vá para a página da chave de API e faça login. Você pode usar Google, ou um endereço de e-mail e senha.
  2. Resgate o crédito de teste. Após o login, a página da chave tem um botão para $0,50 de crédito de teste. É um clique, não precisa de cartão, é válido por 7 dias e limitado a um por pessoa.

O teste é pequeno de propósito. A $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, $0,50 cobre um bom número de requisições de teste. Um prompt de 1.000 tokens com uma resposta de 500 tokens custa $0,00015 de entrada mais $0,00025 de saída, o que dá $0,0004. Dividindo $0,50 por isso, obtém-se 1.250 requisições assim, então você tem bastante espaço para experimentar.

Observe os limites da chave de teste: 2 requisições simultâneas e 60 requisições por minuto. Uma chave completa, que você obtém após recarregar, permite 8 requisições simultâneas e 300 por minuto. Se seu loop de teste executa requisições simultâneas e você vê erros 429, este é o primeiro ponto a verificar.

Etapa 3: criar a chave e armazená-la com segurança

Na mesma página, crie uma chave de API e copie-a. Trate-a como uma senha. Coloque-a em uma variável de ambiente ou gerenciador de segredos, nunca em um repositório, bundle de front-end ou captura de tela. Se uma chave vazar, remova-a e crie uma nova.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

Código do lado do servidor deve ler a variável em tempo de execução. Código do navegador nunca deve guardar a chave: envie requisições do seu backend, pois tudo enviado ao navegador é visível para todos os visitantes.

Etapa 4: listar modelos para confirmar a chave

O teste mais barato possível é o endpoint de modelos. Ele não gera texto, então é uma verificação limpa da chave, da URL e da sua rede.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

Você deve receber uma lista JSON que inclua uncensored. Se receber 401, a chave está errada ou tem espaço ou aspas extras ao redor. Se a conexão falhar, verifique se a URL termina em /v1 e que você usou https.

Etapa 5: enviar a primeira requisição de chat

Agora uma resposta real. O corpo segue o formato padrão de chat completions.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

A resposta contém choices[0].message.content e um bloco usage com contagens de tokens de prompt e conclusão. Veja também os cabeçalhos de resposta, com curl -i. Você verá X-Request-Id, que o suporte pode usar para encontrar sua requisição, X-Balance-USD, seu crédito restante, e os cabeçalhos de limite de requisições X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency.

Parâmetros como temperature, top_p, stop, seed e as penalidades são passados diretamente. max_tokens é opcional. Se você não o definir, a conclusão pode usar o que restar da janela.

Etapa 6: a mesma chamada de um SDK

Uma vez que o curl funcione, passe para a linguagem que você realmente usará. Apenas dois argumentos mudam em uma configuração OpenAI padrão.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.minimaxapikey.com/v1",
    api_key=os.environ["UNCENSORED_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

Para streaming, adicione stream: true e leia os eventos enviados pelo servidor. O uso aparece no final do streaming. A página de documentação cobre streaming, chamada de funções e modo JSON com response_format: {"type":"json_object"}.

Migrando um projeto OpenAI existente

Na maioria das vezes, o projeto que você quer conectar já funciona com a biblioteca de cliente OpenAI. Nesse caso, você raramente edita código. Os SDKs oficiais leem as variáveis de ambiente OPENAI_API_KEY e OPENAI_BASE_URL quando você não passa argumentos, então uma alteração de implantação pode ser suficiente.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

A única edição restante é o nome do modelo. Uma string como um ID de modelo OpenAI não existirá aqui, então substitua por uncensored, idealmente via valor de configuração para que você possa reverter. Leia o código para ver os recursos que o serviço não oferece. Geração de imagem, áudio, embeddings e fine-tuning não estão disponíveis, pois esta é uma API de chat apenas para texto. Se seu app chama embeddings para busca, você precisará de outro provedor para essa parte e pode manter o chat neste.

Também ajuda saber qual é o modelo. É um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto lícito, e um limite rígido se aplica independentemente das configurações: sem conteúdo sexual envolvendo menores de idade. Prompts escritos para outro modelo podem precisar de pequenos ajustes, já que cada modelo reage diferentemente ao mesmo prompt de sistema. Execute seus próprios prompts de teste lado a lado antes de mudar o tráfego real.

Configurações que vale a pena escolher no primeiro dia

Algumas decisões são mais fáceis de tomar na configuração do que após o lançamento. Nenhuma é difícil, mas cada uma evita uma surpresa depois.

  • Um prompt de sistema. Coloque suas instruções sobre tom, formato e papel em uma mensagem system. Mantenha-a curta e específica, porque toda requisição a repete como tokens de entrada.
  • Um limite de tokens. max_tokens é opcional, mas um limite é uma proteção barata. Sem ele, uma única resposta pode usar o restante da janela de 100.000 tokens.
  • Streaming para uso interativo. Defina stream: true se uma pessoa estiver esperando pela resposta. Para trabalhos em lote, requisições simples são mais fáceis.
  • Uma regra de nova tentativa para 429. Trate 429 como um sinal para esperar, não como uma falha. Quando a resposta inclui Retry-After: 5, esperar esse tempo e tentar novamente é o movimento correto.
  • Tamanho da requisição. O limite do corpo é 8 MB. Isso é muito mais do que um prompt normal precisa, mas logs colados ou documentos podem atingir isso.

Prompts não são usados para treinamento, o que importa se você planeja enviar documentos internos ou mensagens de usuários. Você ainda é o responsável pelo que envia, então evite colocar segredos que o modelo não precisa em um prompt.

Recarregando após o teste

O teste é para verificar se tudo funciona. Quando estiver pronto para construir, adicione crédito pré-pago. Não há assinatura: você paga por tokens usados, a $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, e o crédito nunca expira, então um saldo não utilizado não desaparece no final do mês.

Qualquer valor inteiro de $20 a $500 funciona. Uma recarga de $50 adiciona um bônus de 5%, $100 adiciona 10% e $200 adiciona 15%. Como exemplo rápido, uma recarga de $100 com seu bônus de 10% dá $110 de crédito. No prompt de 1.000 tokens e resposta de 500 tokens do passo dois, cada requisição custa $0,0004, então $110 cobre 275.000 requisições. Prompts reais costumam ser maiores, então ajuste essa figura para sua média.

Corrigindo erros comuns de configuração

SintomaCausa provávelCorreção
401 em todas as chamadasChave faltando, digitada errada ou revogadaEnvie Authorization: Bearer <key>, sem aspas extras
404 ou resposta HTMLCaminho errado, geralmente falta /v1Use a URL base completa terminando em /v1
Modelo não encontradoUm nome de modelo copiado de outro provedorUse uncensored
429 com rate_limitedAcima do limite de requisições por minutoReduza a velocidade ou recarregue para migrar dos limites de teste para os limites completos
429 com concurrencyMuitas requisições de uma vezLimite chamadas paralelas a 8 (2 em chave de teste)
429 com Retry-After: 5Sobrecarga temporáriaEspere 5 segundos e tente novamente
413 ou corpo rejeitadoRequisição acima de 8 MBReduza o prompt ou divida a tarefa

Quando estiver pronto para mais do que o teste, a página de preços lista as opções de recarga: qualquer valor inteiro de $20 a $500, pago por cripto (USDT em TRC20, USDC em Base), com bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200. Requisições falhas ou recusadas não são cobradas, e prompts não são usados para treinamento.

Perguntas e respostas

Esta é a API oficial do MiniMax?

Não. É uma API independente, hospedada e compatível com OpenAI que serve um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é a API oficial de nenhum fornecedor de modelo e não é um roteador entre fornecedores.

Preciso de cartão de crédito para experimentar?

Não. Após o cadastro, você pode reivindicar $0,50 de crédito de teste com um clique na página da chave de API. É válido por 7 dias e limitado a um por pessoa.

Qual é o nome do modelo para usar nas requisições?

Use uncensored. O serviço expõe este único ID de modelo, e GET /v1/models o mostrará.

Como adiciono mais crédito depois?

Recarregue qualquer valor inteiro de $20 a $500. Bônus aplicam a partir de $50 (+5%), $100 (+10%) e $200 (+15%), e o crédito nunca expira.

Posso usar o SDK da OpenAI?

Sim. Defina base_url para https://api.minimaxapikey.com/v1, use sua chave e envie o parâmetro model uncensored. Nada mais no seu código precisa mudar.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API