Reserva e débito

• 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.
• 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.
• 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.

• 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.

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.

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.

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.

• 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.

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.

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.

{
  "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-…"
  }
}

O histórico de pedidos e débitos está na área pessoal em ailoot.ai. Para cada pedido, são apresentados o modelo, os tokens e o valor.