prepay instance

Deposit credits into a reserved instance to receive usage discounts. The discount rate is calculated based on how many months of usage the prepaid amount covers. Maximum discount is typically 40%.

CLI Usage: vastai prepay instance <id> <amount>

PUT /api/v0/instances/prepay/{id}

prepay instance

cURL

curl --request PUT \
  --url https://console.vast.ai/api/v0/instances/prepay/{id}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 500
}'

200

{
  "success": true,
  "timescale": 3.5,
  "discount_rate": 0.3
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Path Parameters

id · integer · required

ID of the instance to prepay for

Body

application/json

amount · number<float> · required

Amount of credits to prepay

Example:

500

Response

200

application/json

Successfully applied prepayment

success · boolean

Example:

true

timescale · number<float>

Number of months the prepayment will cover

Example:

3.5

discount_rate · number<float>

Applied discount rate (0.0-0.4)

Example:

0.3