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.
| Unidade | Usada em | Um dólar |
|---|---|---|
*_ | Orçamentos e custos de execuções, saldos da carteira e lançamentos do livro-razão | 1000000 |
*_ | Compras pelo Stripe, recargas automáticas e histórico de pagamentos | 100 |
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/meretorna a tarifa comocompute_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
- Quando você cria uma execução, seu status é
reservingenquanto o orçamento inteiro é reservado dos seus créditos disponíveis. Se houver pouco disponível, a requisição falha com402e a execução é registrada comofailed. - Enquanto a execução está ativa,
cost_microsinclui 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. - Depois que a execução termina, a cobrança de computação é recalculada com o tempo realmente usado.
- O Ephemeral cobra o custo final do seu saldo e libera o restante da reserva. Então
billing_pendingpassa a serfalse.
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 carteira | Significado |
|---|---|
balance_ | Créditos que você possui. |
reserved_ | Créditos reservados para execuções que ainda não foram liquidadas. |
available_ | Saldo 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.