O meu agente de IA indica que o pagamento é necessário ou que esgotei os tokens. O que devo fazer?

Na plataforma self-serve, um erro de pagamento implica a disponibilização de uma ligação de pagamento: o utilizador acede à mesma e efetua o pagamento, ou aguarda a renovação da janela de utilização para que o agente tente novamente.

1. Tokens esgotados: a API REST responde com 402 payment_required, um upgrade_url e um cabeçalho Link com rel="payment"; um servidor MCP de plataforma responde a um erro de pagamento com a mesma ligação (página de erro).
2. Janela de utilização de 3 horas esgotada e sem créditos restantes: o REST responde com 429 usage_limit_reached indicando o tempo de reposição, um cabeçalho Retry-After e um upgrade_url para comprar créditos; o MCP responde a um erro de pagamento com os mesmos dados.
3. O limite de despesas foi atingido: 402 payment_required com o motivo spending_cap_reached, até ao final do período ou até que o limite seja aumentado.

Assim que o pagamento é efetuado, o agente consulta GET /v1/account/payment-links/{id} aproximadamente a cada 5 segundos até que o estado seja completado, altura em que reitera o pedido.

O agente não pode realizar pagamentos por conta própria (um agente pode realizar pagamentos?); os créditos são renovados automaticamente apenas se tiver ativado a renovação automática. Não é público se um assistente precisa de voltar a ligar-se após o pagamento. Consulte como lidar com um erro 402 e créditos.

Uma quota num contrato da API REST da Casafari é diferente: consulte quota versus tokens.