Create GPU Instance
Instance
Create GPU Instance
POST
Create GPU Instance
Documentation Index
Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Request Headers
Enum:
application/jsonBearer authentication format, for example: Bearer {{API Key}}.
Request Body
Instance name. String, length limit: 0-255 characters.
GPU product ID. String, length limit: 1-255 characters. You can query this via the List GPU Products API.
Number of GPUs. Integer, valid range: [1, 8].
Root filesystem size. Integer, valid range: [10, 6144]. If the minimum value is less than 10 GB, the system will default to 10 GB. The maximum value is dynamically limited by available storage resources and can be queried via the product list API.
Image URL. String, length limit: 1-500 characters.
Image authentication (username:password). String, length limit: 0-10239 characters.
Image repository authentication ID.
Instance open ports, e.g.: 80/http, 3306/tcp. Supported port range: [1-65535], except for 2222, 2223, 2224 which are reserved for internal use. Supported port types: [tcp, http]. The total number of ports used by ports + tools must not exceed 15.
Instance environment variables. Up to 100 environment variables can be created.
Enable official image support tools. Currently, some official images only include Jupyter. The total number of ports used by ports + tools must not exceed 15.
Instance startup command. String, length limit: 0-2047 characters.
Instance startup entrypoint. This setting will override the Docker image’s ENTRYPOINT. String, length limit: 0-2047 characters.
Specify the cluster ID to create the instance in. If left empty, the instance will be created in a random cluster.
Cloud storage mount configuration. Up to 30 cloud storages can be mounted.
VPC network ID. Leave empty if not using a VPC network.
Instance type. Valid values: [gpu, cpu].
Number of months for subscription instance. Set to 0 to create a pay-as-you-go instance. Integer, value must be greater than or equal to 0.
Instance billing mode. Valid values:
Default:
Note: If month > 0 is set,
onDemand, monthly, spot. Default:
onDemand.Note: If month > 0 is set,
monthly billing mode will be enforced.onDemand: Pay-as-you-go billingmonthly: Monthly subscription billingspot: Spot instance billing
Whether to automatically renew. Boolean, default value: false.
Note: This parameter is only effective when monthly billing is enabled.
Note: This parameter is only effective when monthly billing is enabled.
Number of months to automatically renew. Integer, valid range: [1, 12].
Note: This parameter is only effective when monthly billing is enabled and auto renew is enabled.
Note: This parameter is only effective when monthly billing is enabled and auto renew is enabled.
Minimum CUDA version supported for instance creation. Must be specified in the format: 11.8, 12.4, etc. String, length limit: 0-255 characters.
Response
Created instance ID.