Português
Menu da documentação

Docs do Agent Sandboxes · Conceitos

Preços e cobrança de sandboxes: por segundo, por estado

Atualizado em · 8 min de leitura

Um sandbox é cobrado por segundo pelo que cada estado guarda: o preço do tamanho enquanto roda, 30% disso enquanto está pausado e os bytes guardados enquanto está parado. Iniciar um não custa nada. O preço de um plano é uso que ele inclui, e um saldo que você adiciona paga o resto. Esta página traz todas as tarifas, as regras de arredondamento, os planos e três exemplos calculados.

Em resumo
  • Rodando: US$ 0,009 por vCPU-hora, memória e disco incluídos, por segundo. O SMALL custa US$ 0,018 por hora.
  • Pausado: 30% do preço rodando, por segundo, com memória e processos guardados.
  • Parado: US$ 0,03 por GiB ao mês dos dados do próprio sandbox. Volumes custam US$ 0,20 por GiB ao mês.
  • Inícios são grátis: criar, fazer fork e iniciar um sandbox parado não têm taxa, dentro de um limite por minuto, hora e dia.
  • Planos a partir de US$ 20 por mês, que são US$ 20 de uso incluído. Preços sem IVA.

O que é contado

Quatro medidores contam o uso de um espaço de trabalho:

  • RUNNING: cada segundo em que um sandbox roda, no tamanho dele.
  • PAUSED: cada segundo em que um sandbox fica pausado, no tamanho dele. O servidor guarda a memória e o lugar dele.
  • STORED_GIB: os bytes próprios que o disco de um sandbox STOPPED guarda, que o armazenamento de objetos mantém. Espaço vazio e os arquivos do template não contam.
  • VOLUME_GIB: o tamanho inteiro de um volume, usado ou não.

Templates não são cobrados: o seu plano limita o espaço que eles ocupam. O disco de um sandbox rodando ou pausado está no preço do tamanho dele.

Tarifas

TamanhovCPUs, memória, discoRodando, por horaPausado, por horaRodando, por mêsPausado, por mês
SMALL2, 4 GiB, 10 GiBUS$ 0,018US$ 0,0054US$ 13,14US$ 3,94
DEFAULT4, 8 GiB, 20 GiBUS$ 0,036US$ 0,0108US$ 26,28US$ 7,88
LARGE8, 16 GiB, 40 GiBUS$ 0,072US$ 0,0216US$ 52,56US$ 15,77
XLARGE16, 32 GiB, 80 GiBUS$ 0,144US$ 0,0432US$ 105,12US$ 31,54
  • Todo tamanho custa US$ 0,009 por vCPU-hora, com memória e disco incluídos.
  • Os dados próprios de um sandbox parado custam US$ 0,03 por GiB ao mês; um volume custa US$ 0,20 por GiB ao mês do tamanho dele.
  • Um mês tem 730 horas. Preços sem IVA. Um espaço de trabalho cobrado em euros paga os mesmos números em euros.

Cobrança por segundo, e como uma execução é arredondada

  • Uma execução é um início, uma retomada, um despertar ou a cópia de um fork, até o sandbox pausar, parar ou ser excluído. Os segundos dela são arredondados para cima ao segundo inteiro, e uma execução conta no mínimo 10 segundos.
  • Sem mínimo quando o servidor encerrou a execução: falta de memória ou de disco, reinício da máquina, um espaço de trabalho sem pagamento ou um novo tamanho.
  • Tempo pausado conta segundos inteiros, sem mínimo. Um sandbox pausado pelo reinício do servidor não conta nada.
  • Nada conta duas vezes. Um segundo conta em um tamanho e em um estado, e pausar e acordar nunca transformam tempo rodando em tempo mais barato.

Então a execução mais curta que você paga é de 10 segundos de um sandbox SMALL: US$ 0,00005.

Planos

O preço mensal de um plano também é o uso que ele inclui a cada mês. O plano define ainda um orçamento: quantas vCPUs os seus sandboxes podem ter ao mesmo tempo, o maior tamanho e o espaço para volumes e templates.

Plano, por mêsUso incluídovCPUs ao mesmo tempoMaior tamanhoVolumesTemplates
US$ 20US$ 2020LARGE100 GiB5 GiB
US$ 100US$ 100128XLARGE600 GiB30 GiB
US$ 500US$ 500700XLARGE3.500 GiB175 GiB
US$ 2.000US$ 2.0003.000XLARGE16.000 GiB800 GiB
  • O orçamento de vCPUs conta todo sandbox RUNNING ou PAUSED, todo STOPPED com wake_when_stopped e toda criação, fork ou início em andamento. 20 vCPUs comportam 10 sandboxes SMALL ou 5 DEFAULT ao mesmo tempo, rodando ou pausados. Sandboxes parados não contam, por mais que sejam.
  • Acima de um orçamento, uma chamada responde RESOURCE_EXHAUSTED com LimitReached, que nomeia o limite. Um sandbox pausado já conta, então acordá-lo só é recusado quando o espaço de trabalho tem mais do que o plano permite agora, como depois de mudar para um plano menor.
  • Mudar de plano: um plano mais caro começa um novo mês na hora e soma o que restava do uso incluído; um mais barato começa no mês seguinte, sem reembolso.

Inícios são grátis, dentro de um limite

Criar um sandbox, cada cópia de um fork e iniciar um sandbox STOPPED são inícios, e um início não tem taxa: você paga só pelos segundos que vêm depois. Acordar um sandbox PAUSED nunca é um início. Um plano limita quantos inícios podem acontecer em qualquer minuto, hora e dia, cada janela deslizante:

PlanoInícios por minutoPor horaPor dia
US$ 20363601.200
US$ 100901.2605.040
US$ 5001952.52010.080
US$ 2.0002703.60014.400
Teste grátis1575225

Um início acima de um limite responde RESOURCE_EXHAUSTED com LimitReached: o limit é starts_per_minute, starts_per_hour ou starts_per_day, e o retry_time diz quando inícios suficientes terão saído da janela para a chamada caber. Um fork com mais cópias do que um limite permite não tem retry_time: faça menos cópias de cada vez. Os limites do seu espaço de trabalho estão em Workspace.limits.

Uso incluído

Cada mês do seu plano começa com o preço dele como uso incluído, e cada segundo de cada sandbox é pago primeiro por ele. O que sobra no fim do mês não passa para o seguinte: o próximo mês começa de novo com o valor inteiro do plano.

Saldo

Quando o uso incluído acaba, o seu saldo paga. Você adiciona saldo no painel, de US$ 10 a US$ 1.000 de cada vez, e ele nunca expira. Um saldo pode ficar um pouco abaixo de zero, pelo que rodou entre o último centavo e a parada e pelo que fica guardado depois; o uso incluído do mês seguinte paga isso primeiro.

Teste grátis

O primeiro plano do Agent Sandboxes em uma conta começa com um teste grátis de 7 dias: US$ 1 de uso, 4 vCPUs ao mesmo tempo, tamanhos até DEFAULT e 10 GiB de volumes. Isso dá cerca de 55 horas de um sandbox SMALL rodando, ou 27 de um DEFAULT. É preciso um cartão para começar, e não dá para adicionar saldo durante o teste. O primeiro pagamento do plano vem quando o teste termina, ou quando você inicia o plano antes.

Quando nada paga

Quando o uso incluído acaba e o saldo está vazio, o espaço de trabalho é suspenso:

  • os sandboxes RUNNING e PAUSED dele viram STOPPED, com o motivo UNPAID;
  • nada inicia, é retomado ou acorda, e nenhum volume ou template é criado (UsageUnpaid);
  • o que ele guarda continua sendo contado;
  • adicionar saldo, ou o próximo mês do plano, tira a suspensão em segundos. Os sandboxes então iniciam de novo por ResumeSandbox.

Exemplos calculados

O sandbox de um agente: 2 horas trabalhando e 22 pausado, por dia

Um sandbox DEFAULT para um agente como o Claude Code, com o timer de parada desativado para que os processos fiquem. Ele trabalha 2 horas por dia e espera, pausado, nas outras 22.

  • 2h rodando: 2 × US$ 0,036 = US$ 0,072
  • 22h pausado: 22 × US$ 0,0108 = US$ 0,2376
Um dia: US$ 0,3096. Um mês de 730 horas: cerca de US$ 9,42, contra US$ 26,28 do mesmo sandbox sempre rodando, 64% a menos.

Parado durante a noite, ele custaria ainda menos, mas os processos terminariam. 2 agentes assim cabem no uso incluído do plano de US$ 20, e as 20 vCPUs dele comportam 5 sandboxes DEFAULT ao mesmo tempo.

1.000 evals por dia, 40 segundos cada

Um harness de evals inicia um sandbox SMALL por caso, roda por 40 segundos e o exclui.

  • O custo: 40.000 segundos × US$ 0,000005 = US$ 0,20 por dia, cerca de US$ 6,08 por mês. Os inícios são grátis. Um eval de 3 segundos ainda conta 10: US$ 0,05 por dia para todos eles.
  • No plano de US$ 20: 10 rodam ao mesmo tempo, o que sozinho levaria cerca de 67 minutos, mas o limite de 360 inícios por hora segura o resto: cerca de 2h 19min no total, dentro dos 1.200 inícios por dia.
  • No plano de US$ 100: 64 rodam ao mesmo tempo, limitados a 90 inícios por minuto, então todos levam menos de 12 minutos.
  • Exclua-os, ou defina delete_after_idle_seconds: senão, o lote de cada dia continuaria custando os bytes guardados.

Um preview que dorme

Um sandbox SMALL serve o preview de uma branch em uma porta pública, com o timer de pausa em 120 segundos e o timer de parada desativado. Ele recebe 10 visitas por dia, cada uma de 3 minutos, seguida dos 2 minutos do timer de pausa.

  • Rodando: 3.000 segundos por dia, US$ 0,015.
  • Pausado: os outros 83.400 segundos, US$ 0,125.
  • No total: US$ 0,14 por dia, cerca de US$ 4,26 por mês. Sem nenhuma visita, custa US$ 3,94 por mês.

Uma visita o acorda em cerca de 0,2 s, com o servidor de desenvolvimento onde estava. Um preview pausado conta no orçamento de vCPUs: 10 deles no plano de US$ 20, 64 no plano de US$ 100.

O que US$ 20 compram

1.111 horas de um sandbox SMALL rodando, ou 3.704 horas pausado, ou 667 GiB-mês de sandboxes parados. Um sandbox parado com 2 GiB de dados próprios custa US$ 0,06 por mês.

Onde ver o seu uso

  • O uso de um sandbox é Sandbox.usage: running_seconds, paused_seconds, stored_gib_hours e cost_micros, o que foi cobrado até agora, em milionésimos da moeda. Ele tem no máximo uns 10 segundos de atraso.
  • O uso do espaço de trabalho é ListUsage: uma linha por dia (UTC), medidor e tamanho, como foi cobrado.
  • O que resta é Workspace.billing: o uso incluído restante, o saldo, o fim do mês e se o espaço de trabalho está no teste grátis ou suspenso.
  • No painel, a página Uso do espaço de trabalho mostra o mesmo.

Perguntas

Eu pago enquanto um sandbox está pausado?

Sim, 30% do preço rodando, por segundo: o servidor guarda a memória e o lugar dele. Um sandbox DEFAULT pausado custa US$ 0,0108 por hora.

Há taxa por início?

Não. Criar um sandbox, cada cópia de um fork e iniciar um parado não custam nada; um plano limita quantos podem acontecer por minuto, por hora e por dia. Acordar um sandbox pausado nunca é um início.

O disco é cobrado?

Não enquanto um sandbox roda ou está pausado: o disco está no preço do tamanho. Um sandbox parado paga US$ 0,03 por GiB ao mês pelos dados próprios que o disco guarda, nunca pelo espaço vazio.

Templates são cobrados?

Não. O seu plano limita o espaço que os seus templates ocupam: 5 GiB no plano de US$ 20.

Há uma cobrança mínima por execução?

Uma execução conta no mínimo 10 segundos, então a execução SMALL mais curta custa US$ 0,00005. Segundos pausados não têm mínimo.

O que acontece quando o meu uso incluído acaba?

O seu saldo paga a partir daí. Quando os dois estão vazios, os sandboxes rodando e pausados param até você adicionar saldo ou o próximo mês começar.

Experimente o Pethost Agent Sandboxes

Um teste grátis de 7 dias com US$ 1 de uso e 4 vCPUs; é preciso um cartão. Depois, um plano a partir de US$ 20 por mês, que inclui esse mesmo valor em uso.

Começar o teste grátis