Source: https://ailoot.ai/docs/pt-pt/billing/reserve/ Canonical: https://ailoot.ai/docs/pt-pt/billing/reserve/ Language: pt-pt [Faturação](https://ailoot.ai/docs/pt-pt/) # Reserva e débito [Markdown](https://ailoot.ai/docs/pt-pt/billing/reserve/index.md) Como o Ailoot calcula os valores: reserva antes do pedido, um único débito após a resposta e saldo que nunca fica negativo. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#summary)Descrição breve - **Reserva** — antes de enviar um novo pedido de texto, o Ailoot reserva o custo estimado da entrada e de uma resposta típica, de acordo com as condições aceites para o pedido. Para imagens, vídeo e áudio gerados, mantém-se a reserva integral do custo do resultado. - **Débito** — um único débito, pelo consumo efetivo indicado em `usage`. O restante valor reservado é libertado de imediato. - **Se o dinheiro não chegar sequer para a reserva mínima** — o pedido não é enviado ao modelo e recebe um erro 402 com um texto claro. Não há qualquer débito. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#ailoot-reserve-summary-details)Descrição breve - **Preço** — em dólares por 1 milhão de tokens de entrada e saída (ou por unidade: imagem, segundo de vídeo, caracteres). Os preços de cada modelo estão no [catálogo](https://ailoot.ai/models/pt-pt/). - **Reserva** — antes de enviar um novo pedido de texto, o Ailoot reserva o custo estimado da entrada e de uma resposta típica, de acordo com as condições aceites para o pedido. Para imagens, vídeo e áudio gerados, mantém-se a reserva integral do custo do resultado. - **Limite inferior em vez de rejeição** — se a reserva calculada exceder o saldo disponível ou o limite da chave, só é possível reduzir o limite da resposta para um modelo e um método específicos que o respeitem, e apenas até ao volume que pode ser pago, sem ficar abaixo do mínimo aplicável. Os modelos em que isto funciona estão indicados [abaixo](https://ailoot.ai/docs/pt-pt/billing/reserve/#reserve). - **Débito** — um único débito, pelo consumo efetivo indicado em `usage`. O restante valor reservado é libertado de imediato. - **Se a resposta custar mais do que a reserva** — a diferença é retirada do saldo disponível, não comprometido com outras reservas. O débito nunca excede o saldo: o saldo não fica negativo. - **Se o dinheiro não chegar sequer para a reserva mínima** — o pedido não é enviado ao modelo e recebe um erro 402 com um texto claro. Não há qualquer débito. - **Uma falha sem resultado não é cobrada**. Se a ligação for interrompida, consulte o pedido pelo Request ID no histórico da área pessoal antes de o voltar a enviar. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#reserve)Como é calculada a reserva - **Entrada** é reservada com base numa estimativa do tamanho do pedido e dos anexos suportados, e não num consumo efetivo já conhecido. Para novos pedidos de texto, utiliza-se uma estimativa do corpo e dos anexos segundo o respetivo tipo. O cálculo «4 tokens por byte, mas pelo menos 4096 tokens» aplica-se a reservas anteriormente aceites numa versão antiga e não descreve as novas reservas de texto. Se um anexo for transmitido por ligação (`fileData`) ou estiverem ativadas ferramentas incorporadas, os pedidos de texto suportados incluem uma estimativa separada dos anexos e do trabalho das ferramentas; a sua presença, por si só, não implica reservar toda a janela de entrada. As reservas anteriores mantêm as condições aceites, e a saída de multimédia continua a ser calculada para o resultado completo. - **Saída** é estimada, no cálculo da reserva de um novo pedido de texto, com base no comprimento típico da resposta e nas condições aceites. O limite solicitado é definido através de `max_tokens` (`max_output_tokens` em Responses). O limite solicitado não é automaticamente igual ao número de tokens utilizado no cálculo da reserva nem garante o comprimento efetivo da resposta de um modelo sem uma limitação fiável. O valor inicial de 4096 aplica-se apenas às rotas correspondentes; a regra concreta depende do modelo e do método. - **Preço** é determinado, para novas reservas de texto, tendo em conta as condições deste pedido: o modo normal ou prioritário e os escalões de preço que a estimativa da entrada pode atingir. Dentro das condições selecionadas, o cálculo mantém-se conservador; o modo flex não reduz a reserva. Para um pedido prioritário, a reserva pode ter em conta o modo aplicável mais caro, incluindo priority, flex ou fast. As reservas anteriormente aceites sem estas condições mantêm o cálculo original com base nas tarifas máximas. - **Redução do limite** — quando não é possível cobrir a reserva calculada e o modelo e o método específicos permitem limitar a resposta: os fundos disponíveis têm de cobrir a estimativa da entrada e o volume mínimo de saída. O limite reduzido nunca fica abaixo de 256 tokens (1025 — com raciocínio no formato Anthropic). O modelo recebe o limite já reduzido. Se a reserva calculada exceder o saldo disponível ou o limite da chave, o Ailoot pode, para um modelo e um método suportados, reduzir `max_tokens` (`max_output_tokens` em Responses) até ao volume que pode ser pago, sem ficar abaixo de 256 tokens ou de um mínimo superior exigido pelo método, e comunica essa redução no cabeçalho `X-Ailoot-Max-Tokens-Capped`. A possibilidade de redução é verificada para o modelo de texto e o método específicos. Aplica-se às rotas de texto Gemini suportadas, no formato nativo Gemini e no formato Anthropic Messages; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — nos formatos Chat Completions e Messages (quando suportados pelo modelo). Se o modelo em concreto não respeitar o limite de resposta indicado, o Ailoot não garante que o comprimento efetivo da resposta seja limitado. Para novos pedidos de texto, a reserva continua a basear-se numa estimativa da entrada e de uma resposta típica; se não for possível constituir a reserva mínima, é devolvido o erro 402 sem enviar o pedido. Os pedidos com `previous_response_id` e com ferramentas incorporadas `web_search` ou `code_interpreter` têm em conta, nos novos pedidos de texto, estimativas separadas do contexto guardado e do trabalho das ferramentas; não passam automaticamente a reservar o custo de toda a janela de entrada. As reservas anteriormente aceites mantêm as condições originais. Para imagens, vídeo e áudio gerados, é reservado o custo total do resultado. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#example)Exemplo de cálculo Modelo `claude-sonnet-5-5`: entrada a $2, saída a $10 por 1 milhão de tokens. Enviou 20 000 tokens e o modelo respondeu com 1 200 tokens. | Passo | Cálculo | Valor | | --- | --- | --- | | Entrada efetiva | 20 000 × $2 / 1 000 000 | $0.0400 | | Resposta efetiva | 1 200 × $10 / 1 000 000 | $0.0120 | | **Debitado** | um único débito pelo consumo efetivo | **$0.0520** | No exemplo aritmético apresentado, o custo efetivo é de $0.0520. O débito apresentado pressupõe que a reserva aceite e o saldo livre disponível cobrem esse custo. O montante da reserva não é calculado aqui: para um novo pedido de texto, é determinado separadamente com base na estimativa da entrada e de uma resposta típica e pode ser superior ou inferior ao custo efetivo. A reserva não utilizada é libertada; o limite do débito é apresentado na fórmula abaixo. Débito efetivo = `min(custo real total, reserva aceite + saldo livre não reservado)`. As outras reservas em aberto continuam protegidas; por isso, o saldo total não fica necessariamente a zero. O saldo não fica negativo. Se o custo efetivo exceder a soma da reserva aceite e do saldo disponível não reservado, a diferença por cobrir permanece como prejuízo do Ailoot: não se torna uma dívida sua nem é cobrada posteriormente. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#disconnect)Desligação do cliente Fechar a ligação, atingir o tempo limite da sua aplicação ou não ler uma resposta já concluída não cancela automaticamente o pedido: a resposta concluída do modelo é cobrada uma única vez. Se o resultado não for entregue por responsabilidade do Ailoot, o dinheiro é devolvido. Se a ligação for interrompida, consulte o pedido pelo Request ID no histórico da área pessoal antes de o voltar a enviar. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#bigger-reserve)Porque é por vezes necessário um saldo superior - Para novos pedidos de texto, a reserva para a resposta é calculada com base num comprimento típico, tendo em conta o valor definido para `max_tokens` e as condições do modelo em concreto. Trata-se de uma estimativa da reserva, não de uma garantia do comprimento ou do custo efetivos da resposta. - Nos modelos sem um limite fiável para o comprimento efetivo da resposta, a estimativa da reserva não constitui um limite de comprimento. Para novos pedidos de texto, não é automaticamente substituída pelo custo da resposta mais longa. As reservas anteriormente aceites mantêm as suas condições originais. - As imagens na entrada acrescentam à reserva uma estimativa do respetivo custo. - Os agentes (Claude Code, Codex CLI, Cline) enviam um contexto grande em cada passo: um passo pode reservar dezenas de cêntimos. Mantenha pelo menos alguns dólares de saldo. - Sugestão: defina um valor razoável para `max_tokens` — isto reduz a reserva nos modelos cujo comprimento de resposta pode ser limitado. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#cache)Cache de prompts Os modelos com cache têm preços distintos para escrita e leitura da cache. A leitura costuma ser várias vezes mais barata do que a entrada normal. Os preços estão na ficha do modelo no catálogo. ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#402)Erro 402 Se o saldo disponível não chegar sequer para a reserva mínima, o Ailoot não envia o pedido e responde com 402 e o código `insufficient_balance`. Se o limite total de despesas da chave estiver esgotado — código `api_key_quota_exhausted`. Se a conta tiver uma dívida resultante de um pagamento contestado — código `payment_disputed`: os novos pedidos ficam suspensos até a dívida ser liquidada. 402 Payment Required ```json { "error": { "code": "insufficient_balance", "reason": "insufficient_balance", "type": "insufficient_quota", "param": null, "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….", "request_id": "5c0e7a1d-…" } } ``` ## [](https://ailoot.ai/docs/pt-pt/billing/reserve/#usage)Onde consultar as despesas O histórico de pedidos e débitos está na área pessoal em [ailoot.ai](https://ailoot.ai). Para cada pedido, são apresentados o modelo, os tokens e o valor. Ainda tem dúvidas? Envie o Request ID e uma descrição — ajudamos a esclarecer.[Contactar o suporte](mailto:support@ailoot.ai) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.