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

# Gerenciamento de chaves de API

> Crie credenciais de API para modelos, defina escopo e limites, configure mapeamento e fallback e desative, substitua ou exclua chaves com segurança.

As chaves de API autenticam as solicitações aos modelos. Crie chaves separadas para aplicações ou finalidades diferentes, para acompanhar o uso e desativar o acesso individualmente.

<h2 id="create-key">
  Criar uma chave
</h2>

1. Abra **Chaves de API** no console e confirme a conta e o workspace.
2. Crie uma chave com um nome fácil de identificar.
3. Defina o escopo de modelos, a cota e a expiração conforme necessário e salve.
4. Copie a chave para uma variável de ambiente ou um gerenciador de segredos e siga o [guia de início rápido](/pt/quick-start).

Se a janela de criação informar que a chave completa é exibida apenas uma vez, guarde-a antes de fechar. Mantenha as chaves completas fora de código frontend, repositórios públicos e tickets de suporte.

<h2 id="advanced-settings">
  Configurações avançadas
</h2>

| Objetivo | Recurso |
| - | - |
| Manter o nome do modelo na sua aplicação enquanto chama outro modelo | [Mapeamento de modelos](/pt/api/Model-Mapping-Fallback) |
| Usar um modelo reserva quando as condições de fallback forem atendidas | [Fallback em caso de erro](/pt/api/Model-Mapping-Fallback) |
| Corrigir erros de formatação JSON suportados em saídas estruturadas | [Correção de saída estruturada](/pt/api/structured-output-repair) |

Depois de salvar, verifique a configuração com uma solicitação real. As configurações não adicionam capacidades de entrada, saída ou ferramentas que o modelo de destino não possui.

<h2 id="manage-key">
  Desativar, substituir ou excluir
</h2>

* **Desativar**: interrompe temporariamente as solicitações com essa chave. Verifique a validade e a expiração antes de reativá-la.
* **Substituir**: crie uma nova chave, atualize sua aplicação, verifique as solicitações e, em seguida, desative a antiga.
* **Excluir**: confirme que as aplicações afetadas já trocaram de credencial antes de concluir a exclusão.

Os workspaces empresariais oferecem [chaves de membro e chaves de sistema](/pt/enterprise/keys). Consulte esse guia para ver as regras de propriedade, permissões e expiração.

<h2 id="troubleshooting">
  Se as solicitações forem restringidas
</h2>

Verifique o status da chave, a expiração, o escopo de modelos, a cota restante e o saldo da conta. As solicitações empresariais também seguem os [orçamentos do workspace](/pt/enterprise/budgets). Analise o erro e o Tid nos [logs de solicitações](/pt/console/request-logs) em vez de tentar repetidamente com uma credencial inválida.

Para gerenciar recursos da conta, use uma [chave de gerenciamento](/pt/platform/management-keys).

Última atualização: 2026-10-13


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