General APIs with JWT

Quote a job on a node

Changed on

What renting this node for hours costs, line by line, at the rates billing charges: compute (price_per_gpu x gpu_count per hour, billed per second), volume and backup storage (per GB-hour stored). Egress is billed at what AWS charges and has no line amount. Nothing is reserved; the rent's own checks (GPU splitting, availability) still apply.

get/executors/{executor_uuid}/quote

Request

  • Base URL: https://lium.io/api
  • URL: https://lium.io/api/executors/{executor_uuid}/quote
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key
    • none

Path parameters

executor_uuidstring uuid required

Query parameters

hoursnumber required
gpu_countinteger nullable

Default: the node's free GPUs (what lium up <node> rents); every GPU when none is free

volume_gbnumber
backup_gbnumber

Response

Successful Response

executor_idstring uuid required
gpu_countinteger required
hoursnumber required
price_per_hournumber required

The pod's hourly price if rented now: price_per_gpu x gpu_count

total_usdnumber required

Sum of the quoted lines; egress is not included

pod_balance_floor_usdnumber required

15 minutes of price_per_hour. A rent needs a balance of more than this plus 15 minutes of each open pod

rent_balance_required_usdnumber nullable

Signed in: the amount the payer's balance must be more than for this rent, pod_balance_floor_usd plus 15 minutes of each open pod; 0 for an account the floor exempts. Null without authentication

Changes

  • 6291d24b3060Revision changes
    • info

      the endpoint scheme security APIKeyHeader was added to the API

    • info

      the endpoint scheme security JwtAccessBearer was added to the API

    • info

      added the optional property to the response with the status

  • 560887f90689Revision changes
    • info

      endpoint added