Deutsch
Menü der Doku

Doku zu Agent Sandboxes · Konzepte

Preise und Abrechnung von Sandboxes: sekundengenau, je Zustand

Aktualisiert · 7 Min. Lesezeit

Eine Sandbox wird sekundengenau für das abgerechnet, was jeder Zustand hält: den Preis ihrer Größe, solange sie läuft, 30 % davon, solange sie pausiert, und ihre gespeicherten Bytes, solange sie gestoppt ist. Sie zu starten kostet nichts. Der Preis eines Tarifs ist enthaltener Verbrauch, und ein Guthaben, das du auflädst, bezahlt den Rest. Diese Seite nennt jeden Preis, die Regeln des Rundens, die Tarife und drei durchgerechnete Beispiele.

Kurz gesagt
  • Laufend: 0,009 $ pro vCPU-Stunde, RAM und Disk inklusive, sekundengenau. SMALL kostet 0,018 $ pro Stunde.
  • Pausiert: 30 % des Preises im Betrieb, sekundengenau, RAM und Prozesse bleiben.
  • Gestoppt: 0,03 $ pro GiB und Monat der eigenen Daten der Sandbox. Volumes kosten 0,20 $ pro GiB und Monat.
  • Starts sind kostenlos: Erstellen, Forken und Starten einer gestoppten Sandbox kosten keine Gebühr, innerhalb eines Limits pro Minute, Stunde und Tag.
  • Tarife ab 20 $ im Monat, das sind 20 $ enthaltener Verbrauch. Preise ohne MwSt.

Was gezählt wird

Vier Zähler messen den Verbrauch eines Workspace:

  • RUNNING: jede Sekunde, die eine Sandbox läuft, zu ihrer Größe.
  • PAUSED: jede Sekunde, die eine Sandbox pausiert, zu ihrer Größe. Der Server hält ihren RAM und ihren Platz für sie.
  • STORED_GIB: die eigenen Bytes, die die Disk einer STOPPED-Sandbox hält und die der Objektspeicher aufbewahrt. Leerer Platz und die Dateien der Vorlage zählen nicht.
  • VOLUME_GIB: die ganze Größe eines Volumes, genutzt oder nicht.

Vorlagen werden nicht abgerechnet: Dein Tarif begrenzt den Platz, den sie belegen. Die Disk einer laufenden oder pausierten Sandbox steckt im Preis ihrer Größe.

Preise

GrößevCPUs, RAM, DiskLaufend, pro StundePausiert, pro StundeLaufend im MonatPausiert im Monat
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 $
  • Jede Größe kostet 0,009 $ pro vCPU-Stunde, RAM und Disk inklusive.
  • Die eigenen Daten einer gestoppten Sandbox kosten 0,03 $ pro GiB und Monat; ein Volume 0,20 $ pro GiB und Monat seiner Größe.
  • Ein Monat hat 730 Stunden. Preise ohne MwSt. Ein Workspace, der in Euro abgerechnet wird, zahlt dieselben Zahlen in Euro.

Sekundengenaue Abrechnung, und wie ein Lauf gerundet wird

  • Ein Lauf ist ein Start, ein Fortsetzen, ein Aufwachen oder die Kopie eines Forks, bis die Sandbox pausiert, stoppt oder gelöscht wird. Seine Sekunden werden auf eine ganze Sekunde aufgerundet, und ein Lauf zählt mindestens 10 Sekunden.
  • Kein Minimum, wenn der Server den Lauf beendet hat: RAM oder Disk voll, ein Neustart seiner Maschine, ein unbezahlter Workspace oder eine neue Größe.
  • Pausierte Zeit zählt ganze Sekunden, ohne Minimum. Eine Sandbox, die für den Neustart ihres Servers pausiert ist, zählt nichts.
  • Nichts zählt doppelt. Eine Sekunde zählt zu einer Größe und in einem Zustand, und Pausieren und Aufwachen machen aus laufender Zeit nie billigere Zeit.

Der kürzeste Lauf, den du bezahlst, sind also 10 Sekunden einer SMALL-Sandbox: 0,00005 $.

Tarife

Der Monatspreis eines Tarifs ist zugleich der Verbrauch, den er jeden Monat enthält. Der Tarif setzt auch ein Budget: wie viele vCPUs deine Sandboxes gleichzeitig halten dürfen, die maximale Größe und den Platz für Volumes und Vorlagen.

Tarif, im MonatEnthaltener VerbrauchvCPUs gleichzeitigMaximale GrößeVolumesVorlagen
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
  • Das vCPU-Budget zählt jede Sandbox, die RUNNING oder PAUSED ist, jede STOPPED-Sandbox mit wake_when_stopped und jedes laufende Erstellen, Forken oder Starten. 20 vCPUs halten 10 SMALL- oder 5 DEFAULT-Sandboxes gleichzeitig, laufend oder pausiert. Gestoppte Sandboxes zählen nicht, egal wie viele.
  • Über einem Budget antwortet ein Aufruf RESOURCE_EXHAUSTED mit LimitReached, das das Limit nennt. Eine pausierte Sandbox zählt schon, also wird ihr Aufwachen nur abgelehnt, wenn der Workspace jetzt mehr hält, als sein Tarif erlaubt, etwa nach dem Wechsel zu einem kleineren Tarif.
  • Tarif wechseln: Ein teurerer Tarif beginnt sofort einen neuen Monat und rechnet an, was vom enthaltenen Verbrauch übrig war; ein billigerer beginnt mit dem nächsten Monat, ohne Erstattung.

Starts sind kostenlos, innerhalb eines Limits

Eine Sandbox zu erstellen, jede Kopie eines Forks und das Starten einer STOPPED-Sandbox sind Starts, und ein Start kostet keine Gebühr: Du zahlst nur die Sekunden danach. Eine PAUSED-Sandbox zu wecken ist nie ein Start. Ein Tarif begrenzt, wie viele Starts in jeder Minute, Stunde und an jedem Tag passieren dürfen, jedes Zeitfenster gleitend:

TarifStarts pro MinutePro StundePro Tag
20 $363601.200
100 $901.2605.040
500 $1952.52010.080
2.000 $2703.60014.400
Testphase1575225

Ein Start über einem Limit antwortet RESOURCE_EXHAUSTED mit LimitReached: Sein limit ist starts_per_minute, starts_per_hour oder starts_per_day, und seine retry_time sagt, wann genug Starts das Zeitfenster verlassen haben, damit der Aufruf passt. Ein Fork mit mehr Kopien, als ein Limit erlaubt, hat keine retry_time: Mach weniger Kopien auf einmal. Die Limits deines Workspace stehen in Workspace.limits.

Enthaltener Verbrauch

Jeder Monat deines Tarifs beginnt mit seinem Preis als enthaltenem Verbrauch, und jede Sekunde jeder Sandbox wird zuerst daraus bezahlt. Was am Monatsende übrig ist, wird nicht übertragen: Der nächste Monat beginnt wieder mit dem ganzen Betrag des Tarifs.

Guthaben

Ist der enthaltene Verbrauch aufgebraucht, zahlt dein Guthaben. Du lädst es in der Konsole auf, von 10 $ bis 1.000 $ auf einmal, und es verfällt nie. Ein Guthaben kann ein wenig unter null fallen, um das, was zwischen seinem letzten Cent und dem Stopp lief, und um das, was danach gespeichert ist; der enthaltene Verbrauch des nächsten Monats zahlt das zuerst.

Testphase

Der erste Tarif für Agent Sandboxes eines Kontos beginnt mit einer Testphase von 7 Tagen: 1 $ Verbrauch, 4 vCPUs gleichzeitig, Größen bis DEFAULT und 10 GiB Volumes. Das sind etwa 55 Stunden einer laufenden SMALL-Sandbox oder 27 einer DEFAULT-Sandbox. Zum Starten ist eine Karte nötig, und das Guthaben lässt sich währenddessen nicht aufladen. Die erste Zahlung für den Tarif kommt, wenn die Testphase endet oder wenn du den Tarif früher startest.

Wenn nichts bezahlt

Ist der enthaltene Verbrauch aufgebraucht und das Guthaben leer, wird der Workspace gesperrt:

  • Seine RUNNING- und PAUSED-Sandboxes werden STOPPED, mit dem Grund UNPAID;
  • nichts startet, wird fortgesetzt oder wacht auf, und kein Volume und keine Vorlage wird erstellt (UsageUnpaid);
  • was er speichert, wird weiter gezählt;
  • eine Aufladung oder der nächste Monat des Tarifs hebt die Sperre in Sekunden auf. Seine Sandboxes starten dann wieder durch ResumeSandbox.

Durchgerechnete Beispiele

Die Sandbox eines Agenten: täglich 2 Stunden Arbeit, 22 pausiert

Eine DEFAULT-Sandbox für einen Agenten wie Claude Code, mit ausgeschaltetem Stopp-Timer, damit ihre Prozesse bleiben. Sie arbeitet 2 Stunden am Tag und wartet die übrigen 22 pausiert.

  • 2 h laufend: 2 × 0,036 $ = 0,072 $
  • 22 h pausiert: 22 × 0,0108 $ = 0,2376 $
Ein Tag: 0,3096 $. Ein Monat mit 730 Stunden: etwa 9,42 $, gegenüber 26,28 $ für dieselbe Sandbox, wenn sie immer läuft, 64 % weniger.

Über Nacht gestoppt würde sie noch weniger kosten, aber ihre Prozesse würden enden. 2 solche Agenten passen in den enthaltenen Verbrauch des Tarifs für 20 $, und seine 20 vCPUs halten 5 DEFAULT-Sandboxes gleichzeitig.

1.000 Evals am Tag, je 40 Sekunden

Ein Eval-Harness startet pro Fall eine SMALL-Sandbox, lässt sie 40 Sekunden laufen und löscht sie.

  • Die Kosten: 40.000 Sekunden × 0,000005 $ = 0,20 $ am Tag, etwa 6,08 $ im Monat. Die Starts sind kostenlos. Ein Eval von 3 Sekunden zählt trotzdem 10: 0,05 $ am Tag für alle.
  • Im Tarif für 20 $: 10 laufen gleichzeitig, was allein etwa 67 Minuten dauern würde, aber das Limit von 360 Starts pro Stunde hält den Rest zurück: etwa 2 h 19 min insgesamt, innerhalb seiner 1.200 Starts pro Tag.
  • Im Tarif für 100 $: 64 laufen gleichzeitig, begrenzt auf 90 Starts pro Minute, also dauern alle zusammen unter 12 Minuten.
  • Lösch sie oder setz delete_after_idle_seconds: Sonst kostet der Stapel jedes Tages weiter seine gespeicherten Bytes.

Eine Vorschau, die schläft

Eine SMALL-Sandbox liefert die Vorschau eines Branches auf einem öffentlichen Port aus, ihr Pause-Timer auf 120 Sekunden, ihr Stopp-Timer aus. Sie bekommt 10 Besuche am Tag, jeder 3 Minuten und danach die 2 Minuten ihres Pause-Timers.

  • Laufend: 3.000 Sekunden am Tag, 0,015 $.
  • Pausiert: die übrigen 83.400 Sekunden, 0,125 $.
  • Insgesamt: 0,14 $ am Tag, etwa 4,26 $ im Monat. Ohne einen einzigen Besuch kostet sie 3,94 $ im Monat.

Ein Besuch weckt sie in etwa 0,2 s, mit ihrem Dev-Server dort, wo er war. Eine pausierte Vorschau zählt gegen das vCPU-Budget: 10 davon im Tarif für 20 $, 64 im Tarif für 100 $.

Was 20 $ kaufen

1.111 Stunden einer laufenden SMALL-Sandbox oder 3.704 Stunden einer pausierten oder 667 GiB-Monate gestoppter Sandboxes. Eine gestoppte Sandbox mit 2 GiB eigenen Daten kostet 0,06 $ im Monat.

Wo du deinen Verbrauch siehst

  • Der Verbrauch einer Sandbox ist Sandbox.usage: running_seconds, paused_seconds, stored_gib_hours und cost_micros, was ihr bisher berechnet wurde, in Millionsteln der Währung. Er ist höchstens etwa 10 Sekunden alt.
  • Der Verbrauch des Workspace ist ListUsage: eine Zeile pro Tag (UTC), Zähler und Größe, wie berechnet.
  • Was übrig ist, ist Workspace.billing: der übrige enthaltene Verbrauch, das Guthaben, das Monatsende und ob der Workspace in seiner Testphase oder gesperrt ist.
  • In der Konsole zeigt die Seite „Verbrauch“ des Workspace dasselbe.

Fragen

Zahle ich, während eine Sandbox pausiert?

Ja, 30 % ihres Preises im Betrieb, sekundengenau: Der Server hält ihren RAM und ihren Platz für sie. Eine pausierte DEFAULT-Sandbox kostet 0,0108 $ pro Stunde.

Gibt es eine Gebühr pro Start?

Nein. Eine Sandbox zu erstellen, jede Kopie eines Forks und das Starten einer gestoppten kosten nichts; ein Tarif begrenzt, wie viele pro Minute, Stunde und Tag passieren dürfen. Eine pausierte Sandbox zu wecken ist nie ein Start.

Wird die Disk abgerechnet?

Nicht, solange eine Sandbox läuft oder pausiert: Die Disk steckt im Preis ihrer Größe. Eine gestoppte Sandbox zahlt 0,03 $ pro GiB und Monat für die eigenen Daten auf ihrer Disk, nie für leeren Platz.

Werden Vorlagen abgerechnet?

Nein. Dein Tarif begrenzt den Platz, den deine Vorlagen belegen: 5 GiB im Tarif für 20 $.

Gibt es eine Mindestgebühr pro Lauf?

Ein Lauf zählt mindestens 10 Sekunden, also kostet der kürzeste SMALL-Lauf 0,00005 $. Pausierte Sekunden haben kein Minimum.

Was passiert, wenn mein enthaltener Verbrauch aufgebraucht ist?

Ab dann zahlt dein Guthaben. Sind beide leer, stoppen laufende und pausierte Sandboxes, bis du auflädst oder der nächste Monat beginnt.

Pethost Agent Sandboxes ausprobieren

Eine Testphase von 7 Tagen mit 1 $ Verbrauch und 4 vCPUs, mit Karte. Danach ein Tarif ab 20 $ im Monat, der genauso viel Verbrauch enthält.

Testphase starten