Visão geral
Um erro de faturamento ou cota da API pode significar que você atingiu um limite de uso aprovado ou um limite de gastos configurado, ou esgotou seus créditos pré-pagos. Verifique o erro antes de alterar as configurações.
Identifique o erro
Verifique error.code na resposta da API. Um erro relacionado ao faturamento ainda pode usar o valor mais amplo insufficient_quota em error.type.
| Código do erro | O que significa | Próxima etapa |
| organization_usage_limit_exceeded | Sua organização atingiu o limite de uso atribuído pela OpenAI. | Confira o limite aprovado e as opções para aumentá-lo. |
| organization_spend_limit_exceeded | Sua organização atingiu um limite rígido de gastos configurado. | Confira os controles de gastos da organização. |
| project_spend_limit_exceeded | Seu projeto atingiu um limite rígido de gastos configurado. | Confira os controles de gastos desse projeto. |
| credit_balance_exhausted | Sua organização não tem mais créditos pré-pagos. | Adicione créditos ao saldo da API. |
Tentar novamente após esses erros não restaurará o acesso sem resolver a questão dos créditos ou limites relevantes. Para mais detalhes, consulte o guia de códigos de erro da API.
Confira seu limite de uso aprovado
Acesse a página Limites da sua organização para verificar o limite mensal de uso aprovado e o nível de uso atuais.
À medida que os gastos da sua organização com a API aumentam, a OpenAI a transfere automaticamente para níveis de uso mais altos. Isso geralmente aumenta os limites de taxa na maioria dos modelos. Use os limites exibidos para sua organização em vez de presumir que todas as contas têm a mesma cota mensal.
Para saber mais sobre os níveis, consulte o guia de limites de taxa da API.
Verifique os controles de gastos configurados
Os alertas de gastos enviam notificações sem interromper o tráfego da API. Os limites rígidos de gastos podem interromper as solicitações afetadas quando o gasto registrado atinge o valor configurado.
Tanto os limites da organização quanto os do projeto podem ser aplicados. O limite de uma organização abrange seus projetos; o limite de um projeto abrange o tráfego faturado para ele. Esses controles são separados do limite de uso aprovado pela OpenAI.
Se um limite rígido causou o erro, alguém com permissão para gerenciar as configurações relevantes poderá aumentá-lo ou removê-lo caso os gastos devam continuar. Caso contrário, ele será redefinido no próximo ciclo mensal. As alterações e a aplicação dos limites não são instantâneas, portanto, o gasto registrado pode ultrapassar um pouco o valor configurado.
Para ver as configurações e instruções, consulte o guia de limites de gastos da API.
Verifique seu saldo pré-pago
Se você esgotou seus créditos pré-pagos, acesse o portal de faturamento da API e selecione Comprar créditos ou Adicionar ao saldo de créditos, conforme a opção exibida, para comprar mais. Pode levar alguns minutos para que o saldo atualizado apareça.
Para saber como configurar e recarregar, consulte: Como configurar o faturamento pré-pago.
Verifique se o erro é de limite de taxa
Os limites de taxa de solicitações e tokens controlam a rapidez com que você pode usar a API. Eles são diferentes dos limites mensais de uso, dos controles de gastos e do saldo pré-pago.
Para erros de limite de taxa de solicitações ou tokens, consulte: Solução de erros de limite de taxa da API.
Se o problema persistir
Antes de encaminhar o problema
Tenha em mãos a mensagem e o código do erro, o horário em que ele ocorreu com seu fuso horário e todos os IDs de solicitação relevantes. Remova informações confidenciais das capturas de tela ou do código que você compartilhar.
Entre em contato com o Suporte da OpenAI
Se suas necessidades ultrapassarem os limites disponíveis para sua organização, se você tiver um caso de uso específico ou se o erro persistir após a correção da causa, entre em contato com o Suporte da OpenAI pelo widget de chat da Central de Ajuda.
Para saber como entrar em contato e quais informações incluir, consulte: Como entrar em contato com o Suporte.