> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fontes de modelos

> As diferenças entre as três fontes de modelos (modelos Plus, suas assinaturas e BYOK) e como adicionar contas de assinatura e API keys.

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](https://docs.aihubmix.com/pt/cloud/models/choose-a-model.md).

## As três fontes de modelos

| | Modelos Plus | Suas assinaturas | BYOK |
| - | - | - | - |
| O que é | Modelos incluídos no plano Plus | Suas próprias contas de assinatura, como ChatGPT ou Claude | Suas próprias API keys (gateways, provedores de modelos ou serviços personalizados) |
| Onde o uso é contabilizado | No plano Plus, sem custo extra | Nos limites do plano dessa conta de assinatura | No provedor correspondente, cobrado pelos preços dele |
| Como conectar | Disponível assim que você tem o Plus | Entre e autorize no seu servidor na nuvem | Digite uma API key |
| Com qual Harness funciona | Conforme mostrado no seletor de modelos | Pelo tipo de assinatura | Pelo formato de API |

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](https://docs.aihubmix.com/pt/cloud/account/plus.md).

![Fontes de modelos nas configurações da conta](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/account.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=8dd61f0e6014c385f37a21beca7a6ec5)

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.

> [!NOTE]
>
> 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](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md).

**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**.

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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](https://docs.aihubmix.com/pt/cloud/environments/your-device.md).

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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.