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.
Consulte o seu limite de utilização aprovado
Aceda à página Limites da sua organização para consultar o limite de utilização mensal aprovado e o nível de utilização atuais.
Os níveis de utilização paga da API são Build, Launch e Grow. A sua organização passa automaticamente para cada um destes níveis quando o valor total das compras de créditos atinge, respetivamente, 5, 100 e 500 dólares. Os níveis superiores oferecem geralmente limites de taxa mais elevados. Consulte a página Limites da sua organização para ver o nível e os limites atuais.
As organizações que já utilizam a API paga transitam automaticamente dos níveis 1–2 para Build, dos níveis 3–4 para Launch e do nível 5 para Grow. Não precisa de efetuar um pagamento adicional para esta migração. Os preços da API e os limites de taxa personalizados mantêm-se inalterados.
Para obter detalhes sobre os níveis, 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.