Conceitos

Orçamentos e faturamento

Como os créditos são reservados, cobrados e liberados.

As execuções no serviço hospedado são pagas com créditos pré-pagos. Toda execução tem um orçamento. O Ephemeral reserva o orçamento inteiro antes de a execução começar, cobra o que ela usou e libera o restante.

Unidades

Todos os valores são números inteiros em dólares americanos, em uma de duas unidades.

UnidadeUsada emUm dólar
*_microsOrçamentos e custos de execuções, saldos da carteira e lançamentos do livro-razão1000000
*_centsCompras pelo Stripe, recargas automáticas e histórico de pagamentos100

Portanto, cost_micros: 10000 é um centavo, e amount_cents: 2500 são $25. Um campo de valor ausente em um objeto de execução equivale a zero.

Quanto custa uma execução

O custo de uma execução tem até três partes.

  • Computação. O tempo desde que a execução sai da fila até terminar, arredondado para cima em segundos inteiros, pela tarifa de computação. Nunca excede a cobrança pelo timeout completo. GET /v1/me retorna a tarifa como compute_micros_per_second.
  • Chamadas ao modelo. Antes de cada chamada ao modelo, o Ephemeral consulta o preço atual do modelo e autoriza um limite superior conservador para a chamada. Quando o provedor informa quanto a chamada realmente custou, esse valor substitui a autorização. Se uma resposta se perder, for interrompida ou chegar sem um custo confiável, o limite superior continua cobrado.
  • Requisições web. Quando a execução tem acesso à web, cada requisição custa $0.001 e cada pesquisa, $0.01, cobrados quando são enviados. As requisições recusadas não são cobradas.

As execuções hospedadas aceitam texto e modelos cujo preço pode ser limitado com antecedência. GET /v1/models lista os modelos que atendem a esse critério, com seus preços.

Orçamentos

Defina o orçamento com max_cost_micros na requisição da execução. Ele pode ir de 1 a 100.000.000 ($100). Se você o omitir, vale o orçamento padrão; GET /v1/me o retorna como default_max_cost_micros.

O orçamento deve cobrir a cobrança de computação pelo timeout completo: no mínimo timeout_seconds multiplicado por compute_micros_per_second. Um orçamento menor é rejeitado com 400; reduza o timeout ou aumente o orçamento.

A 200 microdólares por segundo ($0.72 por hora), o timeout padrão de 300 segundos exige no mínimo 60.000 e o máximo de 3.600 segundos exige 720.000. O orçamento padrão de 500.000 cobre timeouts de até 2.500 segundos.

Durante a execução, qualquer chamada ao modelo cujo limite superior levaria a execução além do orçamento é recusada, assim como qualquer requisição web que o fizesse. Isso mantém a execução dentro do orçamento. A chamada recusada retorna um erro ao agente, e a execução normalmente termina como failed.

Reservar, cobrar, liberar

  1. Quando você cria uma execução, seu status é reserving enquanto o orçamento inteiro é reservado dos seus créditos disponíveis. Se houver pouco disponível, a requisição falha com 402 e a execução é registrada como failed.
  2. Enquanto a execução está ativa, cost_micros inclui a cobrança de computação pelo timeout completo, mais cada chamada ao modelo, pelo custo informado assim que o provedor o envia ou pelo limite superior até lá, mais cada requisição web.
  3. Depois que a execução termina, a cobrança de computação é recalculada com o tempo realmente usado.
  4. O Ephemeral cobra o custo final do seu saldo e libera o restante da reserva. Então billing_pending passa a ser false.
Os custos são provisórios até serem liquidados
Considere cost_micros definitivo somente quando o status da execução for final e billing_pending for false. Antes disso, ele pode ser maior que o valor que você será cobrado.

Créditos e pagamentos

Proprietários e administradores compram créditos no portal do cliente, em Faturamento, pelo Stripe Checkout. Cada compra é de $5 a $10.000. Os créditos são adicionados quando o Stripe confirma o pagamento, geralmente em alguns segundos. Voltar da página do Checkout não adiciona créditos por si só.

Campo da carteiraSignificado
balance_microsCréditos que você possui.
reserved_microsCréditos reservados para execuções que ainda não foram liquidadas.
available_microsSaldo menos as reservas. As novas execuções reservam a partir daqui.

A carteira também mostra os 100 lançamentos mais recentes do livro-razão, vinculados à execução ou ao pagamento por trás de cada um. O livro-razão é um histórico da conta e não é uma nota fiscal; o Stripe fornece um recibo para cada pagamento.

A recarga automática cobra um cartão salvo quando a cobrança de uma execução deixa o seu saldo abaixo de um limite que você escolhe. Ela exige um cartão salvo e o seu consentimento explícito. O valor da recarga é de $5 a $10.000, e o limite é de no mínimo $1 e no máximo o valor da recarga. Salvar um cartão não a ativa. Remover o cartão selecionado sem escolher outro como padrão a desativa.

Reembolsos e contestações são deduzidos do saldo e desativam a recarga automática. Se um reembolso deixar o saldo negativo, as novas execuções ficam bloqueadas até você adicionar créditos.

Os créditos nunca expiram. Até 14 dias depois de uma compra, você pode pedir ao suporte o reembolso, no seu cartão, dos créditos dessa compra que ainda não usou. Créditos já usados ou reservados por uma execução em andamento não são reembolsados. Veja os Termos de Serviço.

Instalações auto-hospedadas
As execuções auto-hospedadas não usam a carteira hospedada e não são cobradas pelo Ephemeral. Você paga diretamente ao seu provedor de modelos e à AWS. Veja a auto-hospedagem.
© 2026 EphemeralProduzido por erni.works
esc

Nada corresponde a “”.