Français
Menu de la documentation

Documentation Agent Sandboxes · Notions

Prix et facturation des sandboxes : à la seconde, selon l’état

Mis à jour le · 9 min de lecture

Une sandbox est facturée à la seconde pour ce que garde chaque état : le prix de sa taille quand elle tourne, 30 % de ce prix quand elle est en pause, et ses octets stockés quand elle est arrêtée. En démarrer une ne coûte rien. Le prix d’une offre est de la consommation incluse, et un solde que vous créditez paie le reste. Cette page donne chaque tarif, les règles d’arrondi, les offres et trois exemples chiffrés.

En bref
  • Active : 0,009 $ par vCPU-heure, mémoire et disque compris, à la seconde. SMALL coûte 0,018 $ de l’heure.
  • En pause : 30 % du prix d’exécution, à la seconde, mémoire et processus gardés.
  • Arrêtée : 0,03 $ par GiB et par mois des données propres à la sandbox. Les volumes coûtent 0,20 $ par GiB et par mois.
  • Les démarrages sont gratuits : créer, dupliquer et démarrer une sandbox arrêtée n’ont pas de frais, dans une limite par minute, par heure et par jour.
  • Des offres dès 20 $ par mois, soit 20 $ de consommation incluse. Les prix sont hors TVA.

Ce qui est compté

Quatre compteurs mesurent la consommation d’un espace de travail :

  • RUNNING : chaque seconde où une sandbox tourne, selon sa taille.
  • PAUSED : chaque seconde où une sandbox est en pause, selon sa taille. Son serveur lui garde sa mémoire et sa place.
  • STORED_GIB : les octets propres que contient le disque d’une sandbox STOPPED, gardés en stockage objet. L’espace vide et les fichiers du template ne sont pas comptés.
  • VOLUME_GIB : la taille entière d’un volume, utilisée ou non.

Les templates ne sont pas facturés : votre offre borne la place qu’ils prennent. Le disque d’une sandbox active ou en pause est compris dans le prix de sa taille.

Tarifs

TaillevCPU, mémoire, disqueActive, de l’heureEn pause, de l’heureActive, par moisEn pause, par mois
SMALL2, 4 GiB, 10 GiB0,018 $0,0054 $13,14 $3,94 $
DEFAULT4, 8 GiB, 20 GiB0,036 $0,0108 $26,28 $7,88 $
LARGE8, 16 GiB, 40 GiB0,072 $0,0216 $52,56 $15,77 $
XLARGE16, 32 GiB, 80 GiB0,144 $0,0432 $105,12 $31,54 $
  • Chaque taille coûte 0,009 $ par vCPU-heure, mémoire et disque compris.
  • Les données propres d’une sandbox arrêtée coûtent 0,03 $ par GiB et par mois ; un volume, 0,20 $ par GiB et par mois de sa taille.
  • Un mois compte 730 heures. Les prix sont hors TVA. Un espace de travail facturé en euros paie les mêmes montants en euros.

Facturation à la seconde, et arrondi d’une exécution

  • Une exécution est un démarrage, une reprise, un réveil ou la copie d’une duplication, jusqu’à ce que la sandbox se mette en pause, s’arrête ou soit supprimée. Ses secondes sont arrondies à la seconde supérieure, et une exécution compte au moins 10 secondes.
  • Pas de minimum quand le serveur a mis fin à l’exécution : mémoire ou disque insuffisant, redémarrage de sa machine, espace de travail impayé, ou nouvelle taille.
  • Le temps en pause compte des secondes entières, sans minimum. Une sandbox mise en pause pour le redémarrage de son serveur ne compte rien.
  • Rien ne compte deux fois. Une seconde compte à une seule taille et dans un seul état, et mettre en pause puis réveiller ne transforme jamais du temps actif en temps moins cher.

L’exécution la plus courte que vous payez est donc de 10 secondes d’une sandbox SMALL : 0,00005 $.

Offres

Le prix mensuel d’une offre est aussi la consommation qu’elle inclut chaque mois. L’offre fixe aussi un budget : combien de vCPU vos sandboxes peuvent occuper en même temps, la plus grande taille, et la place pour les volumes et les templates.

Offre, par moisConsommation inclusevCPU en même tempsPlus grande tailleVolumesTemplates
20 $20 $20LARGE100 GiB5 GiB
100 $100 $128XLARGE600 GiB30 GiB
500 $500 $700XLARGE3 500 GiB175 GiB
2 000 $2 000 $3 000XLARGE16 000 GiB800 GiB
  • Le budget de vCPU compte chaque sandbox RUNNING ou PAUSED, chaque sandbox STOPPED avec wake_when_stopped, et chaque création, duplication ou démarrage en cours. 20 vCPU tiennent 10 sandboxes SMALL ou 5 DEFAULT en même temps, actives ou en pause. Les sandboxes arrêtées ne comptent pas, quel que soit leur nombre.
  • Au-delà d’un budget, un appel répond RESOURCE_EXHAUSTED avec LimitReached, qui nomme la limite. Une sandbox en pause compte déjà : la réveiller n’est donc refusé que si l’espace de travail occupe plus que ce que son offre permet maintenant, comme après un passage à une offre plus petite.
  • Changer d’offre : une offre plus chère commence un nouveau mois tout de suite et ajoute ce qui restait de la consommation incluse ; une offre moins chère commence au mois suivant, sans remboursement.

Les démarrages sont gratuits, dans une limite

Créer une sandbox, chaque copie d’une duplication et démarrer une sandbox STOPPED sont des démarrages, et un démarrage n’a pas de frais : vous ne payez que les secondes qui suivent. Réveiller une sandbox PAUSED n’est jamais un démarrage. Une offre limite le nombre de démarrages sur toute minute, toute heure et toute journée, chaque fenêtre étant glissante :

OffreDémarrages par minutePar heurePar jour
20 $363601 200
100 $901 2605 040
500 $1952 52010 080
2 000 $2703 60014 400
Essai gratuit1575225

Un démarrage au-delà d’une limite répond RESOURCE_EXHAUSTED avec LimitReached : sa limit est starts_per_minute, starts_per_hour ou starts_per_day, et son retry_time dit quand assez de démarrages auront quitté la fenêtre pour que l’appel passe. Une duplication de plus de copies qu’une limite n’en permet n’a pas de retry_time : faites moins de copies à la fois. Les limites de votre espace de travail sont dans Workspace.limits.

Consommation incluse

Chaque mois de votre offre commence avec son prix en consommation incluse, et chaque seconde de chaque sandbox est d’abord payée par elle. Ce qui reste à la fin du mois n’est pas reporté : le mois suivant recommence avec le montant entier de l’offre.

Solde

Une fois la consommation incluse épuisée, c’est votre solde qui paie. Vous le créditez dans la console, de 10 $ à 1 000 $ à la fois, et il n’expire jamais. Un solde peut passer un peu sous zéro, de ce qui a tourné entre son dernier centime et l’arrêt et de ce qui est stocké ensuite ; la consommation incluse du mois suivant paie cela en premier.

Essai gratuit

La première offre d’Agent Sandboxes d’un compte commence par un essai gratuit de 7 jours : 1 $ de consommation, 4 vCPU en même temps, des tailles jusqu’à DEFAULT, et 10 GiB de volumes. Cela fait environ 55 heures d’une sandbox SMALL active, ou 27 d’une DEFAULT. Une carte est demandée pour le commencer, et le solde ne peut pas être crédité pendant l’essai. Le premier paiement de l’offre a lieu à la fin de l’essai, ou quand vous démarrez l’offre plus tôt.

Quand rien ne paie

Quand la consommation incluse est épuisée et que le solde est vide, l’espace de travail est suspendu :

  • ses sandboxes RUNNING et PAUSED passent STOPPED, avec la raison UNPAID ;
  • rien ne démarre, ne reprend ni ne se réveille, et aucun volume ni template n’est créé (UsageUnpaid) ;
  • ce qu’il stocke est toujours compté ;
  • un crédit, ou le mois suivant de l’offre, lève la suspension en quelques secondes. Ses sandboxes redémarrent alors par ResumeSandbox.

Exemples chiffrés

La sandbox d’un agent : 2 heures de travail et 22 en pause par jour

Une sandbox DEFAULT pour un agent comme Claude Code, avec son délai d’arrêt désactivé pour que ses processus restent. Elle travaille 2 heures par jour et attend, en pause, les 22 autres.

  • 2 h active : 2 × 0,036 $ = 0,072 $
  • 22 h en pause : 22 × 0,0108 $ = 0,2376 $
Une journée : 0,3096 $. Un mois de 730 heures : environ 9,42 $, contre 26,28 $ pour la même sandbox toujours active, soit 64 % de moins.

Arrêtée la nuit, elle coûterait encore moins, mais ses processus prendraient fin. 2 agents de ce genre tiennent dans la consommation incluse de l’offre à 20 $, et ses 20 vCPU tiennent 5 sandboxes DEFAULT en même temps.

1 000 évaluations par jour, de 40 secondes chacune

Un harnais d’évaluation démarre une sandbox SMALL par cas, la fait tourner 40 secondes, puis la supprime.

  • Le coût : 40 000 secondes × 0,000005 $ = 0,20 $ par jour, environ 6,08 $ par mois. Les démarrages sont gratuits. Une évaluation de 3 secondes compte quand même 10 : 0,05 $ par jour pour l’ensemble.
  • Avec l’offre à 20 $ : 10 tournent en même temps, ce qui à lui seul prendrait environ 67 minutes, mais la limite de 360 démarrages par heure retient le reste : environ 2 h 19 min en tout, dans ses 1 200 démarrages par jour.
  • Avec l’offre à 100 $ : 64 tournent en même temps, dans la limite de 90 démarrages par minute : le tout prend donc moins de 12 minutes.
  • Supprimez-les, ou fixez delete_after_idle_seconds : sinon, le lot de chaque jour continuerait de coûter ses octets stockés.

Une prévisualisation qui dort

Une sandbox SMALL sert la prévisualisation d’une branche sur un port public, son délai de pause à 120 secondes et son délai d’arrêt désactivé. Elle reçoit 10 visites par jour, chacune de 3 minutes, suivies des 2 minutes de son délai de pause.

  • Active : 3 000 secondes par jour, 0,015 $.
  • En pause : les 83 400 autres secondes, 0,125 $.
  • Au total : 0,14 $ par jour, environ 4,26 $ par mois. Sans aucune visite, elle coûte 3,94 $ par mois.

Une visite la réveille en 0,2 s environ, avec son serveur de développement là où il en était. Une prévisualisation en pause compte dans le budget de vCPU : 10 avec l’offre à 20 $, 64 avec l’offre à 100 $.

Ce que permettent 20 $

1 111 heures d’une sandbox SMALL active, ou 3 704 heures en pause, ou 667 GiB-mois de sandboxes arrêtées. Une sandbox arrêtée qui contient 2 GiB de données propres coûte 0,06 $ par mois.

Où voir votre consommation

  • La consommation d’une sandbox est Sandbox.usage : running_seconds, paused_seconds, stored_gib_hours et cost_micros, ce qui lui a été facturé jusqu’ici, en millionièmes de la devise. Elle date de 10 secondes environ au plus.
  • La consommation de l’espace de travail est ListUsage : une ligne par jour (UTC), compteur et taille, telle qu’elle a été facturée.
  • Ce qui reste est Workspace.billing : la consommation incluse restante, le solde, la fin du mois, et si l’espace de travail est en essai gratuit ou suspendu.
  • Dans la console, la page Consommation de l’espace de travail montre la même chose.

Questions

Est-ce que je paie quand une sandbox est en pause ?

Oui, 30 % de son prix d’exécution, à la seconde : son serveur lui garde sa mémoire et sa place. Une sandbox DEFAULT en pause coûte 0,0108 $ de l’heure.

Y a-t-il des frais par démarrage ?

Non. Créer une sandbox, chaque copie d’une duplication et démarrer une sandbox arrêtée ne coûtent rien ; une offre limite combien peuvent avoir lieu par minute, par heure et par jour. Réveiller une sandbox en pause n’est jamais un démarrage.

Le disque est-il facturé ?

Pas quand une sandbox tourne ou est en pause : le disque est compris dans le prix de sa taille. Une sandbox arrêtée paie 0,03 $ par GiB et par mois pour les données propres que contient son disque, jamais pour l’espace vide.

Les templates sont-ils facturés ?

Non. Votre offre borne la place que prennent vos templates : 5 GiB avec l’offre à 20 $.

Y a-t-il un minimum facturé par exécution ?

Une exécution compte au moins 10 secondes : l’exécution SMALL la plus courte coûte donc 0,00005 $. Les secondes en pause n’ont pas de minimum.

Que se passe-t-il quand ma consommation incluse est épuisée ?

Votre solde paie à partir de là. Quand les deux sont vides, les sandboxes actives et en pause s’arrêtent jusqu’à ce que vous créditiez le solde ou que le mois suivant commence.

Essayez Pethost Agent Sandboxes

Un essai gratuit de 7 jours avec 1 $ de consommation et 4 vCPU, avec une carte. Ensuite, une offre dès 20 $ par mois, qui inclut autant de consommation.

Démarrer l’essai gratuit