NOnodus-compute
Research workspaces

Preview the whole-machine hourly price

Changed on

Read-only estimate for the supplied configuration, including CPU or GPU requirements and runtime storage. Send the same configuration used for workspace creation. For a saved workspace, include workspace_id to account for the additional disk needed to restore its files. A successful estimate does not reserve capacity, lock the price or start compute. Refresh expired estimates before starting. Launch checks price, capacity and account funding again.

post/v1/research-workspaces/quote

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Query parameters

workspace_idstring

Optional saved workspace owned by this account. The supplied configuration must match its current saved revision. Includes restore disk in direct-compute estimates. Returns 404 for an unavailable workspace or 409 for a changed configuration.

Request body

kind'' | 'workspace' | 'instance'

Omission or an empty value preserves a saved workspace. instance creates standalone compute with SSH and local disk only. The kind cannot change after creation. An existing SSH workspace remains a workspace.

namestring required

Unique workspace name within the authenticated account. The names . and .. are not accepted.

environment'pytorch-cuda' | 'pytorch-rocm' | 'pytorch-cpu' | 'custom-cuda' | 'custom-rocm' | 'custom-cpu' required

Qualified software environment for NVIDIA, AMD or CPU compute. Custom environments require a team-visible runtime_id.

runtime_idstring

Optional immutable image identity from capabilities.runtimes. Selects the workspace Linux distribution and software. Must match environment and remain qualified and visible to the team. Omission preserves the existing managed environment. The selected runtime cannot be changed when editing a saved project.

gpustring required

GPU model, not a supplier SKU. Use an empty string for CPU instances. Launch requires an exact qualified configuration and eligible capacity.

gpu_count0 | 1 | 2 | 4 | 8 required

Exact GPU count on one machine. Use zero for CPU instances. These accepted request values do not establish hardware qualification or current availability.

gpu_memory_gbnumber required

Minimum required memory per GPU in GB, not the sum across devices. Positive for GPU instances and zero for CPU instances.

compute_class'accelerator' | 'vm'

Omission retains GPU execution. vm requests a CPU-only workspace and requires capabilities.cpu_instances, a CPU environment, empty gpu, zero gpu_count and zero gpu_memory_gb.

gpu_form_factor'' | 'pcie' | 'sxm' | 'nvl'

Optional required GPU form factor. Omission permits any form factor. Requires direct workspace compute and cannot be set for CPU instances. A selected form factor is enforced during quoting and placement.

vcpusinteger

Minimum vCPUs on a GPU machine. Omission or zero keeps its included resources. CPU instances require exactly 2, 4, 8, 16 or 32 vCPUs.

host_memory_gbnumber

Minimum system RAM in GB, separate from GPU memory. Omission or zero keeps included RAM on GPU machines. CPU instances require a positive value. Custom RAM requires direct workspace compute.

size_gbnumber

Instances require zero and have no saved project storage. For workspaces, omit to use the deployment capacity, or send a positive capacity within capabilities.storage_limit_bytes. With storage_policy_version included-10gb-v1 or r2-standard-10gb-account-v1, send exactly 10 for the 10,000,000,000-byte per-workspace capacity. The account policy shares its free allowance across workspaces. Other deployments use GiB and their displayed capacity limit.

ssh_authorized_keystring

Plain SSH public keys, one per line, up to 20. Private keys, certificates and authorized_keys options are rejected. Machines also admit every SSH key saved by a team member. Instances and SSH-only workspaces on direct compute may omit this field. SSH is then unavailable until a key exists, and a running machine admits newly saved team keys within seconds. Deployments without direct compute still require it and return 400 invalid_ssh_authorized_key when it is missing.

Response

Current exact-configuration estimate

hourly_usdnumber

Public price-sheet reference in USD per hour for the entire machine. Omitted when that configuration has no published rate. This is not the final compute charge. Do not multiply by gpu_count.

public_price_availableboolean required

Whether the public sheet lists an hourly rate for this configuration. A missing public rate does not block starting available compute.

currency'USD' required
gpu_count0 | 1 | 2 | 4 | 8 required
observed_atstring date-time required
expires_atstring date-time required

Refresh the estimate after this timestamp.

estimate_onlytrue required

Changes

  • ba84c74aeec8Revision changes
    • breaking

      added subschema #1 to the request body allOf list

    • breaking

      added 'else' subschema to the request body

    • breaking

      added 'if' subschema to the request body

    • breaking

      added 'then' subschema to the request body

    • breaking

      the response property became optional for the status

    • warning

      the request property's min was set to 0.00

    • 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

      added the new 0.00 enum value to the response property for the response status

    • info

      added the new optional query request parameter workspace_id

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the new 0.00 enum value to the request property

    • info

      added the new custom-cpu enum value to the request property

    • info

      added the new custom-cuda enum value to the request property

    • info

      added the new custom-rocm enum value to the request property

    • info

      added the new pytorch-cpu enum value to the request property

    • info

      added the new pytorch-rocm enum value to the request property

    • info

      the request property's min was decreased from 0.00 to 0.00

    • info

      the request property's minLength was decreased from 1 to 0

    • info

      added the required property to the response with the status

  • 544fef290a54Revision changes
    • breaking

      added the new required request property

    • breaking

      the request property became required

    • breaking

      removed the enum value 0.00 of the request property

    • breaking

      removed the enum value custom-cpu of the request property

    • breaking

      removed the enum value custom-cuda of the request property

    • breaking

      removed the enum value custom-rocm of the request property

    • breaking

      removed the enum value pytorch-cpu of the request property

    • breaking

      removed the enum value pytorch-rocm of the request property

    • breaking

      the request property's min was increased to 0.00

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      removed the required property from the response with the status

    • warning

      removed subschema #1 from the request body allOf list

    • warning

      deleted the query request parameter workspace_id

    • warning

      the request property's exclusiveMinimum was set to 0.00

    • 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

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      removed 'else' subschema from the request body

    • info

      removed 'if' subschema from the request body

    • info

      removed 'then' subschema from the request body

    • info

      the response property became required for the status

    • info

      removed the 0.00 enum value from the response property for the response status