Visão geral
Um erro de faturação ou quota da API pode significar que atingiu um limite de utilização aprovado ou um limite de despesas configurado, ou que esgotou os seus créditos pré-pagos. Verifique o erro antes de alterar as definições.
Identifique o erro
Verifique error.code na resposta da API. Um erro relacionado com a faturação pode continuar a usar o valor mais abrangente insufficient_quota em error.type.
| Código de erro | O que significa | Passo seguinte |
| organization_usage_limit_exceeded | A sua organização atingiu o limite de utilização atribuído pela OpenAI. | Reveja o limite aprovado e as opções para o aumentar. |
| organization_spend_limit_exceeded | A sua organização atingiu um limite máximo de despesas configurado. | Reveja os controlos de despesas da organização. |
| project_spend_limit_exceeded | O seu projeto atingiu um limite máximo de despesas configurado. | Reveja os controlos de despesas desse projeto. |
| credit_balance_exhausted | A sua organização já não tem créditos pré-pagos. | Adicione créditos ao seu saldo da API. |
Repetir estes pedidos não reporá o acesso sem resolver a questão dos créditos ou limites relevantes. Para obter mais informações, consulte o guia de códigos de erro da API.
Reveja o seu limite de utilização aprovado
Aceda à página Limites da sua organização para consultar o limite mensal de utilização atualmente aprovado e o respetivo escalão de utilização.
À medida que as despesas da sua API aumentam, a OpenAI transfere automaticamente a sua organização para escalões de utilização superiores. Normalmente, isto aumenta os limites de taxa na maioria dos modelos. Use os limites apresentados para a sua organização, em vez de partir do princípio de que todas as contas têm a mesma franquia mensal.
Para obter detalhes sobre os escalões, consulte o guia de limites de taxa da API.
Verifique os controlos de despesas configurados
Os alertas de despesas enviam notificações sem interromper o tráfego da API. Os limites máximos de despesas podem bloquear os pedidos afetados quando as despesas registadas atingem o montante configurado.
Podem aplicar-se limites da organização e do projeto. Um limite da organização abrange os respetivos projetos; um limite de projeto abrange o tráfego faturado a esse projeto. Estes controlos são independentes do limite de utilização aprovado pela OpenAI.
Se o erro tiver sido causado por um limite máximo, alguém com permissão para gerir as definições relevantes pode aumentá-lo ou removê-lo, caso se pretenda continuar a gastar. Caso contrário, será reposto no próximo ciclo mensal. As alterações e a aplicação dos limites não são imediatas, pelo que as despesas registadas podem exceder ligeiramente o montante configurado.
Para consultar as definições e instruções, veja o guia de limites de despesas da API.
Verifique o seu saldo pré-pago
Se esgotou os seus créditos pré-pagos, aceda ao portal de faturação da API e selecione Comprar créditos ou Adicionar ao saldo de créditos, consoante a opção apresentada, para comprar mais. O saldo atualizado pode demorar alguns minutos a aparecer.
Para obter instruções de configuração e carregamento, consulte: Configurar a faturação pré-paga.
Verifique se é um erro de limite de taxa
Os limites de taxa de pedidos e tokens controlam a rapidez com que pode utilizar a API. São diferentes dos limites mensais de utilização, dos controlos de despesas e do seu saldo pré-pago.
Para erros de limite de taxa de pedidos ou tokens, consulte: Resolver erros de limite de taxa da API.
Se o problema persistir
Antes de encaminhar o problema
Tenha consigo a mensagem e o código do erro, a hora a que ocorreu com o respetivo fuso horário e todos os IDs de pedido relevantes. Remova informações confidenciais das capturas de ecrã ou do código que partilhar.
Contacte o Apoio da OpenAI
Se as suas necessidades ultrapassarem os limites disponíveis para a sua organização, tiver um caso de utilização específico ou o erro persistir depois de resolver a causa, contacte o Apoio da OpenAI através do widget de chat do Centro de Apoio.
Para saber como contactar o Apoio e que informações incluir, consulte: Contactar o Apoio.