Docs do Agent Sandboxes · Conceitos
Preços e cobrança de sandboxes: por segundo, por estado
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.
- 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
| Tamanho | vCPUs, memória, disco | Rodando, por hora | Pausado, por hora | Rodando, por mês | Pausado, por mês |
|---|---|---|---|---|---|
| SMALL | 2, 4 GiB, 10 GiB | US$ 0,018 | US$ 0,0054 | US$ 13,14 | US$ 3,94 |
| DEFAULT | 4, 8 GiB, 20 GiB | US$ 0,036 | US$ 0,0108 | US$ 26,28 | US$ 7,88 |
| LARGE | 8, 16 GiB, 40 GiB | US$ 0,072 | US$ 0,0216 | US$ 52,56 | US$ 15,77 |
| XLARGE | 16, 32 GiB, 80 GiB | US$ 0,144 | US$ 0,0432 | US$ 105,12 | US$ 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ês | Uso incluído | vCPUs ao mesmo tempo | Maior tamanho | Volumes | Templates |
|---|---|---|---|---|---|
| US$ 20 | US$ 20 | 20 | LARGE | 100 GiB | 5 GiB |
| US$ 100 | US$ 100 | 128 | XLARGE | 600 GiB | 30 GiB |
| US$ 500 | US$ 500 | 700 | XLARGE | 3.500 GiB | 175 GiB |
| US$ 2.000 | US$ 2.000 | 3.000 | XLARGE | 16.000 GiB | 800 GiB |
- O orçamento de vCPUs conta todo sandbox RUNNING ou PAUSED, todo STOPPED com
wake_when_stoppede 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_EXHAUSTEDcomLimitReached, 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:
| Plano | Inícios por minuto | Por hora | Por dia |
|---|---|---|---|
| US$ 20 | 36 | 360 | 1.200 |
| US$ 100 | 90 | 1.260 | 5.040 |
| US$ 500 | 195 | 2.520 | 10.080 |
| US$ 2.000 | 270 | 3.600 | 14.400 |
| Teste grátis | 15 | 75 | 225 |
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
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_hoursecost_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.