On-Demand vs. Reserved
Both use Hyperbolic’s platform capacity through the same application. The only real difference is how you pay for it:
Same GPUs, networking, and setup. Reserved locks in the capacity at a lower price.
When to use Reserved
- You have predictable, sustained GPU usage
- You want a lower rate than on-demand in exchange for committing to a term
- You want capacity secured for the duration of your reservation
How it works
Choose a fixed term when you create your instance and pay up front. Reserved instances run for the full reservation period and cannot be terminated early by you.Extending a reservation
You can extend a running reservation before the term ends, in the app or with the API. Extensions are prepaid at today’s rate, with the same term discounts available at reservation time. Only one extension can be pending at a time; once the extended term begins, you can extend again. The instance keeps its IP, data, and configuration.In the app
Open the instance’s details page and click Extend Reservation on the Billing card, or select it from the Actions menu. During the last 3 days of the reservation, Extend Reservation also appears in the page header. Choose a term, and the extension is added on top of your current end date. The dialog shows a calendar that opens at your current end date. Select a quick pick, such as 1 Week or 2 Weeks, or pick the day the reservation should now end, from 1 to 30 days after the current end. Each quick pick shows its discount. The summary and Extend button show the price for that length. If your balance doesn’t cover the extension, the dialog shows how much you’re short and lets you add funds without leaving it.With the API
- Get a quote with
GET /v2/on-demand/get-reservation-extension-quote. PasstermPeriodDays, from 1 to 30, to get the price for your length asrequestedOption. - Extend with
POST /v2/on-demand/extend-reserved. Send the quotedrequestedOption.totalPriceCentsasexpectedTotalPriceCents, and the quote’s top-levelreservedUntilascurrentReservedUntil.
Converting an on-demand rental to reserved
You can convert a running on-demand rental to a reserved term. The conversion takes effect right away. The instance keeps its IP, data, and configuration. The term is prepaid from your credits, together with any on-demand usage not billed yet. You can choose any whole number of days from 1 to 30. Conversions get the same discounts as new reservations. 1 to 6 days get no discount, and longer lengths get the rate of the longest standard term they fully cover.In the app
- Open the instance’s details page and click Upgrade to Reserved on the Billing card, or select it from the Actions menu.
- In the Change Your Duration dialog, select Reserved term. In the calendar, select a quick pick or pick the day the reservation should end, from 1 to 30 days from today. If your balance is short, you can add funds without leaving the dialog.
- Check the Total Cost and click Switch to Reserved.
With the API
- Get a quote with
GET /v2/on-demand/get-reserved-conversion-quote. PasstermPeriodDaysto get the price for your length asrequestedOption. - Convert with
POST /v2/on-demand/convert-to-reserved. Send the quotedtotalPriceCentsasexpectedTotalPriceCents.
What happens at the end of the term
What happens is controlled by Reservation Protection, a setting on each reserved instance. It is on by default when you launch a reserved instance, unless you turn it off.- Reservation Protection on: the instance keeps running after the reservation ends and is billed hourly at the current on-demand rate until you terminate it. Billing switches to on-demand when the reservation ends. The details page then reads Converted to on-demand. You can’t terminate the instance for a few minutes after the reservation ends, while Hyperbolic finishes the conversion.
- Reservation Protection off: the instance is terminated at the end of the reservation. The details page reads Reservation ended · terminating. On-machine data is not recoverable, so save anything you need to persistent storage or an external service before the end date.
If you extend the reservation, these emails count down to the new end date instead.
You can set Reservation Protection when you create the reservation, or toggle it at any time before the term ends from Instance Settings on the instance’s details page.
Both on-demand and reserved capacity are self-serve through the app. For large commitments, you can also work with our team directly — contact sales to discuss volume pricing and terms.