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.
- 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:
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
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.
1
Abrir o Gerenciamento de chaves
Acesse Key Management e encontre a chave de API que você deseja configurar.
2
Abrir as configurações de acesso a modelos
Ao criar ou editar a chave, abra a seção Model Access.
3
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.
4
Salvar
Depois que você salvar, as novas configurações de acesso a modelos podem levar algum tempo para entrar em vigor.
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 erromodel_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.
Para gerenciar programaticamente o acesso a modelos de uma chave, consulte Get API Key Model Access Policy.