Use alertas de gastos para acompanhar os custos mensais da API. Para interromper o tráfego quando os gastos registrados atingirem o valor configurado, aplique um limite rígido de gastos à organização ou a um projeto específico.
Limites rígidos de gastos podem interromper o tráfego de produção. Quando os gastos registrados atingem
um limite rígido aplicável, as solicitações de API afetadas retornam o erro 429 com o código
organization_spend_limit_exceeded ou project_spend_limit_exceeded.
A aplicação do limite não é imediata. Por isso, os gastos registrados podem ultrapassar um pouco
o valor configurado.
Escolha como controlar os gastos
Os alertas de gastos e os limites rígidos de gastos têm efeitos diferentes.
| Controle | O que acontece ao atingir o valor configurado | Quando usar |
|---|---|---|
| Alerta de gastos | Envia uma notificação e o tráfego da API continua | Para acompanhar os gastos sem interromper o tráfego |
| Limite rígido de gastos | As solicitações de API afetadas retornam o erro 429 |
Para aplicar um teto mensal de gastos à organização ou ao projeto |
Os alertas de gastos não impõem um teto. Eles continuam ativos quando você adiciona um limite rígido de gastos. Assim, você pode receber uma notificação antes que o limite rígido interrompa o tráfego.
A OpenAI também aprova e atribui à sua organização um limite mensal de uso com base no nível de uso da organização. Esse limite de uso aprovado pela OpenAI é independente dos limites de gastos que você configura.
Configure um limite de gastos
Você precisa de permissão para gerenciar as configurações da organização ou do projeto em questão. Para mais detalhes, consulte as permissões da Plataforma de API.
- Acesse Limites da organização.
- Em Gastos, selecione Editar limite de gastos.
- Informe o Limite mensal de gastos.
- Para que a API retorne um erro quando a organização atingir o limite, ative Aplicar um limite rígido.
- Selecione Salvar.
- Acesse as configurações do projeto.
- Selecione Limites.
- Em Gastos, selecione Editar limite de gastos.
- Informe o Limite mensal de gastos.
- Para que a API retorne um erro quando o projeto atingir o limite, ative Aplicar um limite rígido.
- Selecione Salvar.
Entenda como os limites rígidos funcionam
Uma mesma solicitação pode estar sujeita tanto ao limite rígido da organização quanto ao do projeto.
- O limite rígido da organização se aplica ao tráfego da API em todos os projetos da organização.
- O limite rígido do projeto se aplica apenas ao tráfego da API cobrado desse projeto.
- Quando a organização atinge o limite rígido, a API retorna o erro
429com o códigoorganization_spend_limit_exceeded. - Quando o projeto atinge o limite rígido, a API retorna o erro
429com o códigoproject_spend_limit_exceeded. - Se você aumentar ou remover o limite atingido, o tráfego poderá ser retomado assim que a atualização se propagar. Caso contrário, o limite será redefinido no próximo ciclo mensal.
A aplicação do limite não é imediata. Enquanto a informação de que o limite foi atingido se propaga, a Plataforma de API ainda pode processar um pequeno volume de tráfego adicional. Por isso, os gastos registrados podem ultrapassar um pouco o valor configurado.
Alertas de gastos
Use alertas de gastos para receber notificações antes que os gastos atinjam um limite rígido. Configure os alertas em valores que deem tempo para ajustar o uso, aumentar o limite ou investigar tráfego inesperado.
Restabeleça o tráfego da API
Se as solicitações falharem por causa de um limite de cobrança ou do saldo de créditos, siga estas etapas.
- Consulte
error.codepara verificar se a solicitação atingiu o limite de gastos da organização, o limite de gastos do projeto ou o limite de uso atribuído pela OpenAI, ou se a organização esgotou os créditos pré-pagos. - Para
organization_spend_limit_exceededouproject_spend_limit_exceeded, compare o uso atual com os limites de gastos configurados. Se precisar restabelecer o tráfego antes da redefinição mensal, aumente ou remova o limite atingido. - Para
organization_usage_limit_exceeded, solicite um aumento do limite de uso aprovado. - Para
credit_balance_exhausted, adicione créditos. - Se o erro indicar um limite de taxa de solicitações ou de tokens, siga as orientações do guia de limites de taxa.