Saltar para o conteúdo principal
A fonte de modelos determina quem fornece o modelo em uma sessão e onde o uso é contabilizado. Você pode usar os modelos incluídos no plano Plus ou conectar suas próprias contas de assinatura ou API keys. As três fontes são configuradas em Settings › Account e selecionadas na sessão pelo seletor de modelos. Consulte Escolher um modelo.

As três fontes de modelos

Os modelos Plus aparecem atualmente no app como o grupo AIHubMix, com o rótulo Default account. Eles são listados primeiro na seção BYOK de Settings › Account e na aba BYOK do seletor de modelos. Clique no ícone de lápis nessa linha para escolher quais modelos Plus aparecem no seletor de modelos. Clique em Reset to default para restaurar todos os modelos do plano. Os modelos Plus só mostram um status quando atingem o limite de uso ou ficam temporariamente indisponíveis. Eles não mostram valores nem números de uso. Se você mesmo adicionar uma API key da AIHubMix, ela é cobrada pelo provedor como qualquer outra key e é separada do Plus. Sem o Plus, os modelos Plus não podem ser usados. Consulte Plano Plus.
Fontes de modelos nas configurações da conta

Settings › Account: as seções Your subscriptions e BYOK

Adicionar uma conta de assinatura

Depois que você conecta uma assinatura, os modelos são executados com os limites de assinatura dessa conta. A entrada e a autorização acontecem no seu próprio servidor na nuvem. A AIHubMix não armazena nem retransmite as credenciais da sua assinatura. As assinaturas que você pode adicionar são listadas na janela de adição, por exemplo ChatGPT e Claude.
Antes de adicionar, verifique se o seu servidor na nuvem está em execução. Caso contrário, a conexão falha. Consulte Servidor na nuvem.
1

Abrir a janela de adição

Na seção Your subscriptions de Settings › Account, clique em Add a subscription (ou em + se você já tiver contas). Quando a aba Subscriptions do seletor de modelos estiver vazia, você também pode clicar em Connect subscription.
2

Escolher um provedor e confirmar o nome

O nome diferencia várias contas do mesmo provedor. Leia os termos, marque a caixa de seleção para concordar e clique em Continue.
3

Autorizar no navegador

A janela fornece o endereço de uma página de autorização. Clique em Open ou copie-o para o navegador, depois entre e autorize.
4

Concluir a última etapa

  • ChatGPT (browser sign-in): depois que você entra, o navegador vai para uma página que não carrega. Copie o endereço completo da barra de endereços, cole-o de volta na janela e clique em Submit.
  • ChatGPT (device code): abra o link em qualquer navegador ou no celular e digite o código mostrado na janela. Se não conseguir entrar, ative primeiro a entrada por código de dispositivo nas configurações de segurança da sua conta do ChatGPT.
  • Claude: cole o código de autorização da página de autorização de volta na janela e clique em Submit.
Depois de conectada, a conta aparece na lista. O nível do plano vem da conta, então você não precisa escolhê-lo. Você pode conectar várias contas do mesmo provedor, por exemplo uma pessoal e uma de trabalho. O seletor de modelos as agrupa pelo nome da conta. Uma delas tem o rótulo Default e é usada por padrão nas novas sessões. Clique em Make default em outra conta para alterá-la. Clique no ícone de lápis na linha de uma conta para renomeá-la. Os nomes têm até 32 caracteres e devem ser únicos.

Quando uma assinatura precisa ser reconectada ou esgota os limites

  • Authorization expired, ou uma mensagem informa que você entrou manualmente em um terminal: clique em Reconnect na linha da conta e autorize novamente seguindo as etapas acima.
  • Limites esgotados: a sessão é pausada, e as alterações feitas até então e o ambiente são mantidos. Você pode trocar para outra conta do mesmo provedor, trocar para outro modelo ou adicionar uma nova conta e continuar. O sistema não troca de conta automaticamente.
Você pode ver o uso e o horário de reinício de cada conta em Settings › Usage.
Clicar em Disconnect remove a conta imediatamente, sem confirmação. As sessões que usam essa conta são pausadas e só podem continuar depois que você trocar de modelo.

Adicionar uma API key

BYOK (Bring Your Own Key) significa usar sua própria API key, cobrada pelo provedor correspondente. Você pode adicionar até 10 keys. A linha de modelos Plus não conta para esse limite.
1

Abrir a janela de adição

Na seção BYOK de Settings › Account, clique em +. Quando a aba BYOK do seletor de modelos estiver vazia, você também pode clicar em Add API key.
2

Escolher um provedor

Escolha um gateway como OpenRouter, SiliconFlow ou Groq, um provedor de modelos como OpenAI, Anthropic ou DeepSeek, ou escolha Custom para digitar seu próprio endereço. Depois da escolha, a Base URL e o formato de API são preenchidos automaticamente. Clique em Edit para alterá-los.
3

Digitar a key e escolher os modelos

Depois que você digita a API key, a lista de modelos é obtida automaticamente, com os modelos recomendados já selecionados. Adicione ou remova modelos conforme necessário. Para modelos que não estão na lista, digite o ID do modelo para adicioná-lo. Se a obtenção falhar, tente novamente ou digite os nomes dos modelos manualmente.
4

Adicionar

O nome é opcional. Clique em Add, e a key aparece na lista BYOK. A partir daí, o app mostra apenas a key mascarada.
Cada key tem um formato de API: o Claude Code precisa de Anthropic compatible, e o Codex CLI precisa de OpenAI compatible. Todos os provedores predefinidos, exceto a Anthropic, usam OpenAI compatible por padrão. Se o seu serviço oferece as duas APIs, adicione outra key para ele com o outro formato.
Se a Base URL for um endereço de rede interna, as sessões executadas no servidor na nuvem não conseguem acessar essa key. Você só pode usá-la em sessões executadas no seu dispositivo. Consulte Executar no seu dispositivo.
Para substituir uma key, clique no ícone de lápis na linha da key, digite a nova key e salve. Salvar com o campo vazio mantém a key original. Não é possível alterar o provedor de uma key salva. Clicar no ícone de lixeira a exclui imediatamente, sem confirmação. Editar uma key ou os modelos Plus não altera o modelo usado pelas sessões que já começaram.

Recorrer aos modelos Plus quando uma key falha

À direita do título da seção BYOK há uma chave, Fall back to Plus models, desativada por padrão.
  • Quando desativada, se uma chamada com a key falhar, a tarefa atual retorna um erro.
  • Quando ativada, se uma key ficar sem crédito, sofrer limitação de taxa ou se tornar inválida, a tarefa continua com os modelos Plus. Sem o Plus, ela passa a valer depois que você assinar.
A chave fica indisponível até você adicionar uma key.

Modelos de tarefas do sistema

Os modelos usados em tarefas em segundo plano, como reparo do ambiente e nomeação de sessões, aparecem na seção System task models de Settings › Account, somente para visualização. Para alterar um deles, altere AI assistant na linha da fonte correspondente (automático por padrão, e normalmente não é preciso alterar).