> ## Documentation Index > Fetch the complete documentation index at: https://gcore.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Preview GPU cluster price > Preview the billing price for a GPU cluster. **Deprecated**: Use the new v2 endpoints instead: - `/v2/pricing/{project_id}/{region_id}/gpu/virtual/clusters` for virtual GPU clusters - `/v2/pricing/{project_id}/{region_id}/gpu/baremetal/clusters` for bare metal GPU clusters ## OpenAPI ````yaml /api-reference/services_documented/cloud_api.yaml post /cloud/v1/pricing/{project_id}/{region_id}/ai/clusters openapi: 3.1.0 info: title: Gcore OpenAPI – Cloud API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: '2026-05-07T20:33:46.548242+00:00' servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Bare Metal x-displayName: Bare Metal - name: Container as a Service x-displayName: Container as a Service - name: Cost Reports x-displayName: Cost Reports - name: DDoS Protection x-displayName: DDoS Protection - name: Everywhere Inference x-displayName: Everywhere Inference - name: Everywhere Inference Apps x-displayName: Everywhere Inference Apps - name: File Shares x-displayName: File Shares - name: Floating IPs x-displayName: Floating IPs - name: Function as a Service x-displayName: Function as a Service - name: GPU Bare Metal x-displayName: GPU Bare Metal - name: GPU Virtual x-displayName: GPU Virtual - name: IP Ranges x-displayName: IP Ranges - name: Images x-displayName: Images - name: Instances x-displayName: Instances - name: Load Balancers x-displayName: Load Balancers - name: Logging x-displayName: Logging - name: Managed Kubernetes x-displayName: Managed Kubernetes - name: Managed PostgreSQL x-displayName: Managed PostgreSQL - name: Networks x-displayName: Networks - name: Placement Groups x-displayName: Placement Groups - name: Projects x-displayName: Projects - name: Quotas x-displayName: Quotas - name: Regions x-displayName: Regions - name: Registry x-displayName: Registry - name: Reservations x-displayName: Reservations - name: Reserved IPs x-displayName: Reserved IPs - name: Routers x-displayName: Routers - name: SSH Keys x-displayName: SSH Keys - name: Secrets x-displayName: Secrets - name: Security Groups x-displayName: Security Groups - name: Snapshot Schedules x-displayName: Snapshot Schedules - name: Snapshots x-displayName: Snapshots - name: Tasks x-displayName: Tasks - name: User Actions x-displayName: User Actions - name: User Role Assignments x-displayName: User Role Assignments - name: Volumes x-displayName: Volumes paths: /cloud/v1/pricing/{project_id}/{region_id}/ai/clusters: post: tags: - GPU Bare Metal summary: Preview GPU cluster price description: >- Preview the billing price for a GPU cluster. **Deprecated**: Use the new v2 endpoints instead: - `/v2/pricing/{project_id}/{region_id}/gpu/virtual/clusters` for virtual GPU clusters - `/v2/pricing/{project_id}/{region_id}/gpu/baremetal/clusters` for bare metal GPU clusters operationId: AIClusterPricingPreviewHandler.post parameters: - in: path name: project_id required: true description: Project ID schema: description: Project ID example: 1 examples: - 1 format: int64 title: Project Id type: integer - in: path name: region_id required: true description: Region ID schema: description: Region ID example: 1 examples: - 1 format: int64 title: Region Id type: integer requestBody: content: application/json: schema: $ref: >- #/components/schemas/LegacyGPUClusterPricingPreviewRequestSerializer responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/InstancePricingPreviewV2ResponseSerializer deprecated: true components: schemas: LegacyGPUClusterPricingPreviewRequestSerializer: description: Pricing schema for AI cluster creation with detailed prices per category example: flavor: bm1-ai-small-v1pod-4 instances_count: 1 interfaces: - floating_ip: source: new network_id: ddc28e44-2acb-499b-985b-831f29432e1c subnet_id: 2731a56e-a5c9-44be-80c2-02c57c594573 type: subnet name: poplar-ubuntu volumes: - size: 10 source: image type_name: ssd_hiiops - size: 5 source: new-volume type_name: standard - snapshot_id: 7cca40d7-a843-4e9f-ae08-62b9a394b1ab source: snapshot examples: - flavor: bm1-ai-small-v1pod-4 instances_count: 1 interfaces: - floating_ip: source: new network_id: ddc28e44-2acb-499b-985b-831f29432e1c subnet_id: 2731a56e-a5c9-44be-80c2-02c57c594573 type: subnet name: poplar-ubuntu volumes: - size: 10 source: image type_name: ssd_hiiops - size: 5 source: new-volume type_name: standard - snapshot_id: 7cca40d7-a843-4e9f-ae08-62b9a394b1ab source: snapshot properties: flavor: description: AI cluster flavor title: Flavor type: string instances_count: default: 1 description: >- A multiplier that would be used to calculate the price, multiplying the flavor, IP, and volume prices by this number title: Instances Count type: integer interfaces: description: Subnet IPs and floating IPs items: $ref: '#/components/schemas/NewVmInterfaceSerializersPydantic' title: Interfaces type: array name: description: AI cluster name title: Name type: string volumes: description: Volumes attached to the AI cluster items: $ref: '#/components/schemas/InstanceVolumePricingRequestSerializer' title: Volumes type: array required: - name - flavor - interfaces title: LegacyGPUClusterPricingPreviewRequestSerializer type: object InstancePricingPreviewV2ResponseSerializer: description: Billing response v2 preview schema for server instance. properties: currency_code: anyOf: - enum: - AZN - EUR - USD type: string - type: 'null' description: Currency code (3-letter code per ISO 4217). examples: - USD - EUR title: Currency Code discount_details: description: Discount details per resource. example: discount: '0.5' resource: ssd_hiiops examples: - discount: '0.5' resource: ssd_hiiops items: $ref: '#/components/schemas/ResourceDiscountSerializer' title: Discount Details type: array discount_percent: description: Actual discount as a relative value. example: '10.50' examples: - '10.50' - '5.00' title: Discount Percent type: string per_gb: anyOf: - $ref: '#/components/schemas/DetailedInstancePricingPerGBSerializer' - type: 'null' description: Pricing details per category charged per GB. examples: - egress_traffic_baremetal: 1.3 egress_traffic_virtual: 0.5 per_hour: $ref: '#/components/schemas/DetailedInstancePricingSerializer' description: Prices per category charged per hour. examples: - external_ip: 0.02 flavor: 0.8 floating_ip: 0.05 volumes: cold: 0.1083 ssd_hiiops: 0.0278 standard: 0.0139 per_month: $ref: '#/components/schemas/DetailedInstancePricingSerializer' description: Prices per category charged per month. examples: - external_ip: 14.4 flavor: 576 floating_ip: 36 volumes: cold: 78 ssd_hiiops: 20 standard: 10 price_status: $ref: '#/components/schemas/PriceDisplayStatus' description: Price status for the UI. examples: - show - hide price_without_discount_per_month: anyOf: - type: number - type: 'null' description: Total price VAT inclusive per month without discount. examples: - '800.00' - '1000.50' title: Price Without Discount Per Month tax_percent: description: Tax rate applied to the subtotal, represented as a percentage example: 0 examples: - 0 - 17 - 12 title: Tax Percent type: number total_price_per_hour: anyOf: - type: number - type: 'null' description: Total price VAT inclusive per hour. examples: - '1.02' - '2.50' title: Total Price Per Hour total_price_per_month: anyOf: - type: number - type: 'null' description: Total price VAT inclusive per month. examples: - '734.4' - '1200.00' title: Total Price Per Month vm_count: default: 1 description: Number of virtual machine instances being created. example: 1 examples: - 1 - 10 title: Vm Count type: integer required: - currency_code - discount_percent - per_hour - per_month - price_status - price_without_discount_per_month - total_price_per_hour - total_price_per_month - tax_percent - per_gb - discount_details title: InstancePricingPreviewV2ResponseSerializer type: object NewVmInterfaceSerializersPydantic: discriminator: mapping: any_subnet: $ref: '#/components/schemas/NewInterfaceAnySubnetFipSerializerPydantic' external: $ref: '#/components/schemas/NewInterfaceExternalSerializerPydantic' reserved_fixed_ip: $ref: >- #/components/schemas/NewInterfaceReservedFixedIpFipSerializerPydantic subnet: $ref: >- #/components/schemas/NewInterfaceSpecificSubnetFipSerializerPydantic propertyName: type oneOf: - $ref: '#/components/schemas/NewInterfaceExternalSerializerPydantic' - $ref: '#/components/schemas/NewInterfaceSpecificSubnetFipSerializerPydantic' - $ref: '#/components/schemas/NewInterfaceAnySubnetFipSerializerPydantic' - $ref: >- #/components/schemas/NewInterfaceReservedFixedIpFipSerializerPydantic title: NewVmInterfaceSerializersPydantic InstanceVolumePricingRequestSerializer: description: Schema lists only the fields required to calculate price example: size: 1000 source: new-volume type_name: standard examples: - size: 1000 source: new-volume type_name: standard properties: size: anyOf: - type: integer - type: 'null' default: null description: Volume size in GiB. examples: - 1000 title: Size snapshot_id: anyOf: - type: string - type: 'null' default: null description: >- The snapshot ID. It is mandatory if the volume is created from a snapshot. examples: - 7cca40d7-a843-4e9f-ae08-62b9a394b1ab title: Snapshot Id source: $ref: '#/components/schemas/VolumeSource' description: >- The source of the volume. It must be one of: 'new-volume', 'image', 'snapshot', 'apptemplate'. examples: - new-volume type_name: anyOf: - $ref: '#/components/schemas/VolumeTypeName' - type: 'null' default: null description: >- The type of the volume. It must be one of: 'standard', 'ssd_hiiops', 'cold', 'ultra'. examples: - standard required: - source title: InstanceVolumePricingRequestSerializer type: object ResourceDiscountSerializer: properties: discount: description: Discount value within range [0..1] where 1 is 100%. example: '0.1' examples: - '0.1' - '0.02' - '0.99' title: Discount type: string resource: description: Resource name. example: ssd_hiiops examples: - ssd_hiiops - egress_traffic_baremetal - egress_traffic_virtual title: Resource type: string required: - resource - discount title: ResourceDiscountSerializer type: object DetailedInstancePricingPerGBSerializer: properties: egress_traffic_baremetal: anyOf: - type: number - type: 'null' default: null description: The price of egress traffic per GB for bare metal instances. examples: - 0.05 - 0.1 title: Egress Traffic Baremetal egress_traffic_virtual: anyOf: - type: number - type: 'null' default: null description: The price of egress traffic per GB for virtual instances. examples: - 0.05 - 0.1 title: Egress Traffic Virtual title: DetailedInstancePricingPerGBSerializer type: object DetailedInstancePricingSerializer: properties: external_ip: anyOf: - type: number - type: 'null' default: null description: Price of external/public IP over the specified period of time. examples: - 14.4 title: External Ip flavor: anyOf: - type: number - type: 'null' default: null description: Price of flavor over the specified period of time. examples: - 576 title: Flavor floating_ip: anyOf: - type: number - type: 'null' default: null description: Price of floating IP over the specified period of time. examples: - 36 title: Floating Ip volumes: anyOf: - $ref: '#/components/schemas/InstanceVolumesPricingSerializer' - type: 'null' default: null description: Prices of volumes per type over the specified period of time. examples: - cold: 78 ssd_hiiops: 20 ssd_lowlatency: 10 standard: 10 ultra: 78 title: DetailedInstancePricingSerializer type: object PriceDisplayStatus: enum: - error - hide - show title: PriceDisplayStatus type: string NewInterfaceAnySubnetFipSerializerPydantic: example: floating_ip: existing_floating_id: 57be69f6-6f6a-4f03-a4ad-8eb86c69ec0a source: existing interface_name: my-any-subnet-interface ip_address: 192.168.6.9 network_id: 59905c8e-2619-420a-b046-536096473370 type: any_subnet examples: - floating_ip: existing_floating_id: 57be69f6-6f6a-4f03-a4ad-8eb86c69ec0a source: existing interface_name: my-any-subnet-interface ip_address: 192.168.6.9 network_id: 59905c8e-2619-420a-b046-536096473370 type: any_subnet properties: floating_ip: description: >- Allows the instance to have a public IP that can be reached from the internet. discriminator: mapping: existing: $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer new: $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' propertyName: source oneOf: - $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' - $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer title: Floating Ip interface_name: description: >- Interface name. Defaults to `null` and is returned as `null` in the API response if not set. maxLength: 37 title: Interface Name type: string ip_address: description: You can specify a specific IP address from your subnet. format: ipvanyaddress title: Ip Address type: string ip_family: anyOf: - $ref: '#/components/schemas/InterfaceIPFamily' - type: 'null' default: ipv4 description: Specify `ipv4`, `ipv6`, or `dual` to enable both. network_id: description: The network where the instance will be connected. format: uuid4 title: Network Id type: string security_groups: description: >- Specifies security group UUIDs to be applied to the instance network interface. items: $ref: '#/components/schemas/MandatoryIdSerializerPydantic' title: Security Groups type: array type: const: any_subnet description: >- Instance will be attached to a subnet with the largest count of free IPs. title: Type type: string required: - type - network_id title: NewInterfaceAnySubnetFipSerializerPydantic type: object NewInterfaceExternalSerializerPydantic: description: Instance will be attached to default external network example: interface_name: eth0 ip_family: ipv4 type: external examples: - interface_name: eth0 ip_family: ipv4 type: external properties: interface_name: description: >- Interface name. Defaults to `null` and is returned as `null` in the API response if not set. maxLength: 37 title: Interface Name type: string ip_family: anyOf: - $ref: '#/components/schemas/InterfaceIPFamily' - type: 'null' default: ipv4 description: Specify `ipv4`, `ipv6`, or `dual` to enable both. security_groups: description: >- Specifies security group UUIDs to be applied to the instance network interface. items: $ref: '#/components/schemas/MandatoryIdSerializerPydantic' title: Security Groups type: array type: const: external description: A public IP address will be assigned to the instance. title: Type type: string required: - type title: NewInterfaceExternalSerializerPydantic type: object NewInterfaceReservedFixedIpFipSerializerPydantic: example: floating_ip: source: new interface_name: my-interface port_id: 59905c8e-2619-420a-b046-536096473370 type: reserved_fixed_ip examples: - floating_ip: source: new interface_name: my-interface port_id: 59905c8e-2619-420a-b046-536096473370 type: reserved_fixed_ip properties: floating_ip: description: >- Allows the instance to have a public IP that can be reached from the internet. discriminator: mapping: existing: $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer new: $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' propertyName: source oneOf: - $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' - $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer title: Floating Ip interface_name: description: >- Interface name. Defaults to `null` and is returned as `null` in the API response if not set. maxLength: 37 title: Interface Name type: string port_id: description: >- Network ID the subnet belongs to. Port will be plugged in this network. title: Port Id type: string security_groups: description: >- Specifies security group UUIDs to be applied to the instance network interface. items: $ref: '#/components/schemas/MandatoryIdSerializerPydantic' title: Security Groups type: array type: const: reserved_fixed_ip description: >- An existing available reserved fixed IP will be attached to the instance. If the reserved IP is not public and you choose to add a floating IP, the instance will be accessible from the internet. title: Type type: string required: - type - port_id title: NewInterfaceReservedFixedIpFipSerializerPydantic type: object NewInterfaceSpecificSubnetFipSerializerPydantic: description: >- The instance will get an IP address from the selected network. If you choose to add a floating IP, the instance will be reachable from the internet. Otherwise, it will only have a private IP within the network. example: floating_ip: existing_floating_id: 57be69f6-6f6a-4f03-a4ad-8eb86c69ec0a source: existing network_id: 59905c8e-2619-420a-b046-536096473370 subnet_id: e3c6ee77-48cb-416b-b204-11b492cc776e3 type: subnet examples: - floating_ip: existing_floating_id: 57be69f6-6f6a-4f03-a4ad-8eb86c69ec0a source: existing network_id: 59905c8e-2619-420a-b046-536096473370 subnet_id: e3c6ee77-48cb-416b-b204-11b492cc776e3 type: subnet properties: floating_ip: description: >- Allows the instance to have a public IP that can be reached from the internet. discriminator: mapping: existing: $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer new: $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' propertyName: source oneOf: - $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer' - $ref: >- #/components/schemas/ExistingInstanceFloatingIpInterfaceSerializer title: Floating Ip interface_name: description: >- Interface name. Defaults to `null` and is returned as `null` in the API response if not set. maxLength: 37 title: Interface Name type: string network_id: description: The network where the instance will be connected. format: uuid4 title: Network Id type: string security_groups: description: >- Specifies security group UUIDs to be applied to the instance network interface. items: $ref: '#/components/schemas/MandatoryIdSerializerPydantic' title: Security Groups type: array subnet_id: description: The instance will get an IP address from this subnet. format: uuid4 title: Subnet Id type: string type: const: subnet description: >- The instance will get an IP address from the selected network. If you choose to add a floating IP, the instance will be reachable from the internet. Otherwise, it will only have a private IP within the network. title: Type type: string required: - type - network_id - subnet_id title: NewInterfaceSpecificSubnetFipSerializerPydantic type: object VolumeSource: enum: - apptemplate - existing-volume - image - new-volume - snapshot title: VolumeSource type: string VolumeTypeName: enum: - cold - ssd_hiiops - ssd_local - ssd_lowlatency - standard - ultra title: VolumeTypeName type: string InstanceVolumesPricingSerializer: description: Pricing schema with detailed prices per volume type. example: cold: 78 ssd_hiiops: 20 ssd_lowlatency: 10 standard: 10 ultra: 78 examples: - cold: 78 ssd_hiiops: 20 ssd_lowlatency: 10 standard: 10 ultra: 78 properties: cold: anyOf: - type: number - type: 'null' default: null description: Price of cold volume over the specified period of time. examples: - 78 title: Cold ssd_hiiops: anyOf: - type: number - type: 'null' default: null description: Price of `ssd_hiiops` volume over the specified period of time. examples: - 20 title: Ssd Hiiops ssd_lowlatency: anyOf: - type: number - type: 'null' default: null description: Price of `ssd_lowlatency` volume over the specified period of time. examples: - 10 title: Ssd Lowlatency standard: anyOf: - type: number - type: 'null' default: null description: Price of standard volume over the specified period of time. examples: - 10 title: Standard ultra: anyOf: - type: number - type: 'null' default: null description: Price of ultra volume over the specified period of time. examples: - 78 title: Ultra title: InstanceVolumesPricingSerializer type: object ExistingInstanceFloatingIpInterfaceSerializer: properties: existing_floating_id: description: >- An existing available floating IP id must be specified if the source is set to `existing` example: e3c6ee77-48cb-416b-b204-11b492cc776e3 examples: - e3c6ee77-48cb-416b-b204-11b492cc776e3 format: uuid4 title: Existing Floating Id type: string source: const: existing description: >- An existing available floating IP will be attached to the instance. A floating IP is a public IP that makes the instance accessible from the internet, even if it only has a private IP. It works like SNAT, allowing outgoing and incoming traffic. example: existing examples: - existing title: Source type: string required: - source - existing_floating_id title: Existing floating IP type: object NewInstanceFloatingIpInterfaceSerializer: properties: source: const: new description: >- A new floating IP will be created and attached to the instance. A floating IP is a public IP that makes the instance accessible from the internet, even if it only has a private IP. It works like SNAT, allowing outgoing and incoming traffic. example: new examples: - new title: Source type: string required: - source title: New floating IP type: object InterfaceIPFamily: enum: - dual - ipv4 - ipv6 title: InterfaceIPFamily type: string MandatoryIdSerializerPydantic: properties: id: description: Resource ID example: ae74714c-c380-48b4-87f8-758d656cdad6 examples: - ae74714c-c380-48b4-87f8-758d656cdad6 format: uuid4 title: Id type: string required: - id title: MandatoryIdSchema schema type: object securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234$abcdef` type: apiKey in: header name: Authorization ````