🤖HermesBlog
Guias Práticos do Hermes · Parte 298/9/2026

Integração OAuth com MiniMax

Integração OAuth com MiniMax — guia fácil de entender baseado na documentação oficial

Pense nas chaves de API como uma chave de casa — elas funcionam, mas você precisa ficar de olho nelas, e se perder uma, fica trancado para fora. OAuth é mais como um cartão magnético de hotel: é temporário, ligado à sua identidade e pode ser reemitido a qualquer momento. Para usuários do MiniMax, é exatamente isso que o Hermes Agent agora oferece.

guide-minimax-oauth

O que há de novo?

O Hermes Agent adicionou suporte a OAuth para o MiniMax, o que significa que você agora pode entrar com sua conta MiniMax em vez de ficar gerenciando uma chave de API. Isso é especialmente útil se você é um usuário pesado do MiniMax e quer uma conexão mais segura e baseada em sessão. A melhor parte? Funciona tanto com o endpoint global quanto com o endpoint da China.

Por que usar OAuth em vez de uma chave de API?

  • Sem gerenciamento de chaves – Chega de copiar, colar ou se preocupar com vazamentos de chaves em arquivos .env.
  • Atualização automática – Os tokens OAuth expiram e se renovam automaticamente, então você não precisa ficar rotacionando chaves manualmente.
  • Mesmas ferramentas, mesmo poder – Você continua tendo acesso a todos os modelos MiniMax, como o MiniMax-M2.7, com a mesma qualidade.

Como configurar

Primeiro, certifique-se de ter o Hermes Agent instalado e atualizado. Depois, adicione suas credenciais OAuth do MiniMax:

hermes auth add minimax-oauth

Isso abrirá uma janela do navegador onde você faz login na sua conta MiniMax e concede acesso. Assim que terminar, você está pronto para conversar.

Usando o MiniMax com OAuth

Agora, em vez de definir MINIMAX_API_KEY em ~/.hermes/.env, você pode simplesmente rodar:

hermes chat --provider minimax --model MiniMax-M2.7

Para usuários na China, use o endpoint dedicado:

hermes chat --provider minimax-cn --model MiniMax-M2.7

O Hermes detecta automaticamente que você está usando OAuth e ignora a verificação da chave de API.

E o endpoint da China?

Se você está no endpoint da China, o fluxo OAuth é o mesmo. Apenas certifique-se de selecionar MiniMax (China) ao adicionar a autenticação:

hermes auth add minimax-cn-oauth

Depois, use --provider minimax-cn como de costume.

Algumas coisas para ter em mente

  • Os tokens OAuth são armazenados com segurança na configuração do Hermes, não em arquivos .env de texto puro.
  • Se o seu token expirar, o Hermes vai pedir para você reautenticar — sem pânico.
  • Você ainda pode usar chaves de API se preferir; OAuth é apenas uma opção adicional.

Resumo

A integração OAuth do MiniMax no Hermes Agent é como trocar uma chave física por uma fechadura inteligente. É mais seguro, mais conveniente e elimina o incômodo de gerenciar chaves. Esteja você no endpoint global ou no da China, agora você pode conversar com os modelos MiniMax em segundos.

Dica prática: Se você está testando vários modelos MiniMax, defina seu provedor permanentemente no config.yaml:

model:
  provider: "minimax"
  default: "MiniMax-M2.7"

Depois, é só rodar hermes chat sem nenhuma flag. Boas construções!


📖 Documentação oficial

この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › guides/minimax-oauth