Use alertas de gastos para acompanhar os custos mensais da API. Para interromper o tráfego quando os gastos monitorados atingirem um valor configurado, aplique um limite rígido de gastos à sua organização ou a um projeto específico.
Limites rígidos de gastos podem interromper o tráfego de produção. Quando os gastos monitorados atingem
um limite rígido aplicável, as requisições de API afetadas retornam um erro 429 com o código
organization_spend_limit_exceeded ou project_spend_limit_exceeded.
A aplicação do limite não é instantânea, então os gastos registrados podem ultrapassar ligeiramente o
valor configurado.
Escolha um controle de gastos
Alertas de gastos e limites rígidos de gastos têm efeitos diferentes:
| Controle | O que acontece ao atingir o valor configurado | Use quando quiser |
|---|---|---|
| Alerta de gastos | Envia uma notificação; o tráfego da API continua | Acompanhar os gastos sem interromper o tráfego |
| Limite rígido de gastos | As requisições de API afetadas retornam um erro 429 | Aplicar um teto mensal à organização ou ao projeto |
Alertas de gastos não impõem um teto. Eles permanecem ativos quando você adiciona um limite rígido de gastos, permitindo que você receba notificações antes que o limite rígido interrompa o tráfego.
A OpenAI também atribui à sua organização um limite de uso baseado no nível de uso, aprovado para cada mês. 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 Permissões da Plataforma de API.
- Acesse Limites da organização.
- Em Gastos, selecione Editar limite de gastos.
- Insira o Limite mensal de gastos.
- Para que as respostas da API retornem erros após a organização atingir o limite, ative Aplicar um limite rígido.
- Selecione Salvar.
- Acesse Configurações do projeto.
- Selecione Limites.
- Em Gastos, selecione Editar limite de gastos.
- Insira o Limite mensal de gastos.
- Para que as respostas da API retornem erros após o projeto atingir o limite, ative Aplicar um limite rígido.
- Selecione Salvar.
Entenda como os limites rígidos funcionam
Tanto o limite rígido da organização quanto o do projeto podem se aplicar a uma requisição:
- Um limite rígido da organização se aplica ao tráfego da API de todos os projetos da organização.
- Um limite rígido do projeto se aplica apenas ao tráfego da API faturado para esse projeto.
- Ao atingir um limite rígido da organização, as requisições retornam um erro
429com o códigoorganization_spend_limit_exceeded. - Ao atingir um limite rígido do projeto, as requisições retornam um erro
429com o códigoproject_spend_limit_exceeded. - Aumentar ou remover o limite atingido permite que o tráfego seja retomado após a propagação da atualização. Caso contrário, o limite é renovado no próximo ciclo mensal.
A aplicação do limite não é instantânea. A Plataforma de API pode processar uma pequena quantidade de uso adicional enquanto o estado do limite se propaga, então os gastos registrados podem ultrapassar ligeiramente o valor configurado.
Alertas de gastos
Use alertas de gastos para receber notificações antes que os gastos atinjam um limite rígido. Adicione alertas em patamares que deem tempo para ajustar o uso, aumentar o limite ou investigar tráfego inesperado.
Restabeleça o tráfego da API
Se as requisições falharem por causa de um limite relacionado ao faturamento ou do saldo de créditos:
- Verifique
error.codepara identificar se a requisição atingiu um limite de gastos da organização, um limite de gastos do projeto ou um limite de uso atribuído pela OpenAI, ou se a organização esgotou seus créditos pré-pagos. - Para
organization_spend_limit_exceededouproject_spend_limit_exceeded, compare o uso atual com seus limites de gastos. Aumente ou remova o limite atingido se o tráfego precisar ser retomado antes da renovação mensal. - Para
organization_usage_limit_exceeded, solicite um limite de uso aprovado maior. - Para
credit_balance_exhausted, adicione créditos. - Se o erro indicar um limite de taxa de requisições ou tokens, siga o guia de limites de taxa.