Lium GPU Cloud: live GPU prices and rent links

Search the Lium documentation for pages matching the query. Use for how-to questions (renting, SSH, templates, providing GPUs); for live GPU availability or prices use search_gpus or get_gpu_prices instead. Optionally filter by audience (providers, validators, pod-users, developers); without one, pages for the other side (renter or provider, guessed from the query) rank lower.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "audience": {
      "description": "Filter results to a specific audience section",
      "type": "string",
      "enum": [
        "providers",
        "validators",
        "pod-users",
        "developers"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the raw Markdown source for a documentation page. Accepts a full URL, absolute slug (e.g. /providers/quickstart), or basename (e.g. quickstart). On tie among basenames, prefers pages in audience order: Providers > Validators > Renters > Developers.

{
  "type": "object",
  "properties": {
    "url_or_slug": {
      "type": "string",
      "description": "Full URL (https://docs.lium.io/providers/quickstart), absolute slug (/providers/quickstart), or basename (quickstart)"
    }
  },
  "required": [
    "url_or_slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List GPU nodes that can be rented on Lium right now, cheapest per GPU-hour first, with live USD prices and a rent link for each. Use when the user wants a specific machine (GPU model, count, country, price cap); use get_gpu_prices for a price overview. Each node has tier (secure or spot), reliability_score and min_gpus_per_rental (some nodes rent only whole). Read-only: next_step says how to rent one.

{
  "type": "object",
  "properties": {
    "gpu": {
      "description": "GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)",
      "type": "string"
    },
    "count": {
      "description": "GPUs needed on one node",
      "type": "integer",
      "minimum": 1,
      "maximum": 64
    },
    "country": {
      "description": "Two-letter country code, e.g. US, DE",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "max_price_per_gpu_hour": {
      "description": "Price cap in USD per GPU-hour",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "limit": {
      "default": 10,
      "description": "Max nodes to return (default 10, max 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Live price range (min, median, max USD per GPU-hour) and free GPU count for each GPU model rentable on Lium right now. Use for "what does an H100 cost" or comparing models; use search_gpus to pick a node to rent. Pass count for multi-GPU quotes: a 1-GPU price can come from a node with one free GPU.

{
  "type": "object",
  "properties": {
    "gpu": {
      "description": "GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)",
      "type": "string"
    },
    "country": {
      "description": "Two-letter country code, e.g. US, DE",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "count": {
      "description": "GPUs needed on one node: prices only nodes that can rent that many",
      "type": "integer",
      "minimum": 1,
      "maximum": 64
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate what a provider earns per month on Lium by listing GPUs of a model, as the rewards calculator does: rental income (95% of the renter price) and rented extra at the last 30 days' utilisation, plus idle pay at the validator's rate for every unrented hour; with what those GPUs actually earned and the middle-half range across providers. Use when someone asks what their GPUs could earn on Lium; for renting GPUs use search_gpus. An estimate, not a guarantee.

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "GPU model, e.g. H100, B200, RTX 4090 (case and spacing ignored)"
    },
    "count": {
      "default": 1,
      "description": "How many GPUs of that model (default 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 64
    }
  },
  "required": [
    "gpu"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rent a GPU pod on Lium with your API key and wait until it runs; returns the pod id and the ssh command. Spends money from your Lium balance: the pod is billed per second until remove_pod, also when idle. Give gpu (and count, optional max_price_per_gpu_hour and country) to let Lium pick the cheapest matching node, or node_id from search_gpus alone for that node. idempotency_key is required: if a call fails or times out, retry with the same key within 24 hours so it cannot rent twice.

{
  "type": "object",
  "properties": {
    "gpu": {
      "description": "GPU model, e.g. H100, RTX 4090; Lium picks the cheapest node that fits",
      "type": "string"
    },
    "count": {
      "description": "GPUs on one node (default: 1 with gpu, every free GPU with node_id)",
      "type": "integer",
      "minimum": 1,
      "maximum": 64
    },
    "node_id": {
      "description": "A node id from search_gpus, to rent that node",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "template_id": {
      "description": "From list_templates; default: Lium's PyTorch image for the node",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "ssh_public_key": {
      "description": "OpenSSH public key to log in with (e.g. ~/.ssh/id_ed25519.pub); default: the keys saved on your Lium account",
      "type": "string"
    },
    "name": {
      "description": "Pod name",
      "type": "string",
      "maxLength": 60
    },
    "max_price_per_gpu_hour": {
      "description": "Price cap in USD per GPU-hour (with gpu, not node_id)",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "country": {
      "description": "Two-letter country code (with gpu, not node_id)",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "wait_seconds": {
      "default": 25,
      "description": "How long to wait for the pod to run (default 25, max 50)",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,255}$",
      "description": "A new unique string per rental (e.g. a UUID). Send the same key again within 24 hours to retry the same rental: it never rents twice"
    }
  },
  "required": [
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Your Lium pods with status, ssh command and price per hour.

{
  "type": "object",
  "properties": {}
}

One pod: status, ssh command (once RUNNING), price per hour and spend so far.

{
  "type": "object",
  "properties": {
    "pod_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Pod id from rent_pod or list_pods"
    }
  },
  "required": [
    "pod_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Request pod deletion. Billing stops when accepted; deletion may finish asynchronously (get_pod shows DELETING). Data on the pod is lost.

{
  "type": "object",
  "properties": {
    "pod_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Pod id from rent_pod or list_pods"
    }
  },
  "required": [
    "pod_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Your Lium balance in USD.

{
  "type": "object",
  "properties": {}
}

Docker templates a pod can start from (official ones, your own and other users' public ones; official and yours mark which), for rent_pod template_id.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Filter by name or image, e.g. pytorch, vllm",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}