ETethproofs
Clusters

Create a cluster

Changed on
post/clusters

Request

  • Base URL
    https://ethproofs.org/api/v0
  • Auth
    API key in header Authorization

Request body

namestring required

Human-readable name. Main display name in the UI

zkvm_version_idinteger required

ID of the zkVM version. Visit ZKVMs to view all available zkVMs and their IDs.

num_gpusinteger

Number of GPUs in the cluster. Determines if cluster is multi-GPU (>1) or single-GPU (1).

hardware_descriptionstring

Free-form text description of the cluster's hardware for display in the UI

deployment_type'cloud-hosted' | 'on-prem'

Deployment type of the cluster. Determines infrastructure configuration.

Example request

{
  "name": "ZKnight-01",
  "zkvm_version_id": 1,
  "num_gpus": 8,
  "hardware_description": "8x NVIDIA H100 80GB GPUs, AMD EPYC 9654 96-Core Processor",
  "deployment_type": "cloud-hosted"
}

Response

Cluster created

idnumber required

Changes

  • 9774b7b42209Revision changes
    • info

      added the new optional request property

  • 0b475fbd2ae7Revision changes
    • breaking

      added the new required request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property