Reserved TPM

How it works

• You can book Reserved TPM for a start time at least one hour in advance. You will specify:
  • The model and service tier
    • Optional: The LoRA name or ID, if reserving throughput for your LoRA fine-tuned model (note - you must upload your LoRA to Sail first).
  • The duration of the reservation in hours, from 1 hour to 3 days long
  • The reservation start time, from 1 hour to 7 days in advance
  • The uncached input TPM amount to reserve
  • The output TPM amount to reserve
• There is no surcharge for Reserved TPM. The cost of a reservation is simply the cost of pre-paying for the reserved uncached input and output token volume ahead of time: your normal per mTok rates (see Pricing), applied to the TPM and duration you reserve.
• Eligible inference usage during your reservation is guaranteed to be able to meet or exceed the throughput limits you reserved.
• The cost of eligible inference usage during the reservation period first draws down from the prepayment from when you booked the Reserved TPM, then is billed as regular usage once the total prepayment is depleted.

Book and use Reserved TPM

from datetime import datetime, timezone

import sail

reservation = sail.ReservedTpm.create(
    model="deepseek/deepseek-v4-pro-0813",
    service_tier="flex",
    starts_at=datetime(2026, 11, 20, 16, tzinfo=timezone.utc),
    duration_hours=4,
    uncached_input_tpm=1_000_000,
    output_tpm=200_000,
)

print(reservation.id, reservation.status)

import { ReservedTpm } from "@sailresearch/sdk";

const reservation = await ReservedTpm.create({
  model: "deepseek/deepseek-v4-pro-0813",
  serviceTier: "flex",
  startsAt: new Date("2026-11-20T16:00:00Z"),
  durationHours: 4,
  uncachedInputTpm: 1_000_000,
  outputTpm: 200_000,
});

console.log(reservation.id, reservation.status);

curl https://api.sailresearch.com/v1/reserved-tpm \
  -H "Authorization: Bearer $SAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9a8b1fc3-b9da-4b14-bb9b-98978c814b2d" \
  -d '{
    "model": "deepseek/deepseek-v4-pro-0813",
    "service_tier": "flex",
    "starts_at": "2026-11-20T16:00:00Z",
    "duration_hours": 4,
    "uncached_input_tpm": 1000000,
    "output_tpm": 200000
  }'

from datetime import datetime, timezone

import sail

reservation = sail.ReservedTpm.create(
    model="zai-org/GLM-5.3",
    service_tier="flex",
    lora="funnier-v1",
    starts_at=datetime(2026, 11, 20, 16, tzinfo=timezone.utc),
    duration_hours=4,
    uncached_input_tpm=1_000_000,
    output_tpm=200_000,
)

print(reservation.id, reservation.status)

import { ReservedTpm } from "@sailresearch/sdk";

const reservation = await ReservedTpm.create({
  model: "zai-org/GLM-5.3",
  serviceTier: "flex",
  lora: "funnier-v1",
  startsAt: new Date("2026-11-20T16:00:00Z"),
  durationHours: 4,
  uncachedInputTpm: 1_000_000,
  outputTpm: 200_000,
});

console.log(reservation.id, reservation.status);

curl https://api.sailresearch.com/v1/reserved-tpm \
  -H "Authorization: Bearer $SAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f2c8e1a-7b3d-4e9f-a6c5-2d8b1e0f9a73" \
  -d '{
    "model": "zai-org/GLM-5.3",
    "service_tier": "flex",
    "lora": "funnier-v1",
    "starts_at": "2026-11-20T16:00:00Z",
    "duration_hours": 4,
    "uncached_input_tpm": 1000000,
    "output_tpm": 200000
  }'

Errors

Success

Reservation details

{
  "id": "rtpm_019a9b2c-4f1e-7a3d-9c2b-5e8f1a0d6b47",
  "object": "reserved_tpm",
  "model": "deepseek/deepseek-v4-pro-0813",
  "service_tier": "flex",
  "lora": null,
  "starts_at": "2026-11-20T16:00:00Z",
  "ends_at": "2026-11-20T20:00:00Z",
  "duration_hours": 4,
  "uncached_input_tpm": 1000000,
  "output_tpm": 200000,
  "routing": null,
  "price": { "amount_cents": 17712, "currency": "USD" },
  "usage": { "consumed_cents": 0, "remaining_cents": 17712, "as_of": null },
  "free_cancel_until": "2026-11-13T18:12:11Z",
  "refund": null,
  "status": "booked",
  "created_at": "2026-11-13T18:02:11Z",
  "updated_at": "2026-11-13T18:02:11Z",
  "cancelled_at": null
}

Use a reservation

• Responses API
• Chat Completions API
• Messages API

List reservations

import sail

reservations = sail.ReservedTpm.list(limit=20)

import { ReservedTpm } from "@sailresearch/sdk";

const reservations = await ReservedTpm.list({ limit: 20 });

curl "https://api.sailresearch.com/v1/reserved-tpm?limit=20" \
  -H "Authorization: Bearer $SAIL_API_KEY"

Get a reservation

import sail

reservation = sail.ReservedTpm.get("rtpm_019a9b2c-4f1e-7a3d-9c2b-5e8f1a0d6b47")

import { ReservedTpm } from "@sailresearch/sdk";

const reservation = await ReservedTpm.get(
  "rtpm_019a9b2c-4f1e-7a3d-9c2b-5e8f1a0d6b47",
);

curl https://api.sailresearch.com/v1/reserved-tpm/$RESERVATION_ID \
  -H "Authorization: Bearer $SAIL_API_KEY"

Cancel a reservation

import sail

reservation = sail.ReservedTpm.get("rtpm_019a9b2c-4f1e-7a3d-9c2b-5e8f1a0d6b47")
cancelled = reservation.cancel()

print(cancelled.status, cancelled.refund)

import { ReservedTpm } from "@sailresearch/sdk";

const reservation = await ReservedTpm.get(
  "rtpm_019a9b2c-4f1e-7a3d-9c2b-5e8f1a0d6b47",
);
const cancelled = await reservation.cancel();

console.log(cancelled.status, cancelled.refund);

curl -X POST https://api.sailresearch.com/v1/reserved-tpm/$RESERVATION_ID/cancel \
  -H "Authorization: Bearer $SAIL_API_KEY"

FAQ