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

# Acesso a modelos para chaves de API

O acesso a modelos controla quais modelos uma chave de API individual pode chamar. Ele não altera o conjunto de modelos habilitados da sua equipe — apenas restringe, dentro desse conjunto, os modelos que uma determinada chave tem permissão para chamar. Chamadas para modelos fora do intervalo de acesso de uma chave são rejeitadas.

<Info>
  Este recurso abrange modelos da linha de produtos LLM. Recursos multimodais independentes de imagem e vídeo não fazem parte da configuração de acesso a modelos por enquanto.
</Info>

Casos de uso comuns:

* **Isolar chaves por finalidade**: permita que chaves de produção acessem apenas modelos estáveis e que chaves experimentais acessem apenas modelos de baixo custo.
* **Conter riscos rapidamente**: quando uma chave acionar chamadas inesperadas a modelos de alto custo, restrinja-a a alguns modelos seguros.
* **Colaboração externa**: para chaves compartilhadas com contratados ou parceiros, exponha apenas os modelos acordados.

## Modos de acesso

Cada chave de API tem um dos dois modos de acesso:

| Modo de acesso               | Significado                                                                                                                                                                                                                                                    |
| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Todos os modelos habilitados | Modo padrão. A chave pode acessar todos os modelos que sua equipe tem habilitados atualmente, além de modelos habilitados no futuro, e você pode excluir modelos específicos. Modelos habilitados no futuro continuam acessíveis, a menos que sejam excluídos. |
| Apenas modelos selecionados  | A chave pode acessar apenas os modelos que você selecionar. Modelos que sua equipe habilitar posteriormente não são adicionados automaticamente — você precisa adicioná-los manualmente.                                                                       |

Em ambos os modos, os modelos acessíveis nunca excedem o conjunto de modelos habilitados da sua equipe e nunca incluem modelos que foram retirados do ar.

* Todos os modelos habilitados: modelos acessíveis = modelos habilitados da equipe (incluindo futuros) − modelos excluídos.
* Apenas modelos selecionados: modelos acessíveis = modelos selecionados (interseccionados com os modelos habilitados da equipe).

## Configurar o acesso a modelos

<Note>
  Somente administradores da equipe podem configurar o acesso a modelos para uma chave de API. Membros Developer e Basic veem um resumo somente leitura das chaves que podem acessar, mas não podem editá-lo; membros Billing não veem o acesso a modelos.
</Note>

<Steps>
  <Step title="Abrir o Gerenciamento de chaves">
    Acesse [Key Management](https://novita.ai/settings/key-management) e encontre a chave de API que você deseja configurar.
  </Step>

  <Step title="Abrir as configurações de acesso a modelos">
    Ao criar ou editar a chave, abra a seção **Model Access**.
  </Step>

  <Step title="Escolher um modo de acesso">
    Selecione **All enabled models** ou **Selected models only**:

    * Para **All enabled models**, adicione em **Excluded models** quaisquer modelos que você queira bloquear.
    * Para **Selected models only**, adicione pelo menos um modelo em **Accessible models**.
  </Step>

  <Step title="Salvar">
    Depois que você salvar, as novas configurações de acesso a modelos podem levar algum tempo para entrar em vigor.
  </Step>
</Steps>

<Tip>
  Ao criar uma nova chave ou editar uma existente, você pode reutilizar as configurações de outra chave dentro da mesma equipe com **Copy config** e **Paste config**. Depois de colar, você pode salvar diretamente ou ajustar primeiro.
</Tip>

## Quando um modelo é retirado do ar

Se um modelo for retirado do ar pela plataforma, ele sai do conjunto de modelos disponíveis:

* Todas as chamadas para esse modelo retornam imediatamente uma resposta de "modelo indisponível".
* Se a configuração salva de uma chave ainda contiver o modelo offline, ele permanecerá visível, mas esmaecido. Você deve removê-lo antes de salvar — caso contrário, a configuração não poderá ser salva.

## Quando uma chamada é rejeitada

Quando uma chave de API chama um modelo fora do seu intervalo de acesso, a chamada retorna HTTP 403 com o código de erro `model_access_denied`, indicando que a chave não pode acessar esse modelo. Entre em contato com o administrador da sua equipe para ajustar o acesso a modelos da chave. Consulte também [Common Error Codes](/docs/pt-BR/guides/error).

Para gerenciar programaticamente o acesso a modelos de uma chave, consulte [Get API Key Model Access Policy](/docs/pt-BR/api-reference/key-get-model-access-policy).