> ## 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 virtual GPU cluster price

> Preview the billing price for a virtual GPU cluster.



## OpenAPI

````yaml /api-reference/services_documented/cloud_api.yaml post /cloud/v2/pricing/{project_id}/{region_id}/gpu/virtual/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-11T15:10:30.328297+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/v2/pricing/{project_id}/{region_id}/gpu/virtual/clusters:
    post:
      tags:
        - GPU Virtual
      summary: Preview virtual GPU cluster price
      description: Preview the billing price for a virtual GPU cluster.
      operationId: VirtualGpuClusterPricingPreviewHandlerV2.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/VirtualGPUClusterPricingPreviewRequestSerializer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/VirtualGPUClusterPricingPreviewResponseSerializer
components:
  schemas:
    VirtualGPUClusterPricingPreviewRequestSerializer:
      properties:
        flavor:
          description: Virtual GPU cluster flavor
          example: g1-gpu-small-1gpu-6vcpu
          examples:
            - g1-gpu-small-1gpu-6vcpu
          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. Must be greater
            than zero.
          example: 1
          examples:
            - 1
          exclusiveMinimum: 0
          title: Instances Count
          type: integer
        interfaces:
          description: Subnet IPs and floating IPs. Only new floating IPs are supported.
          items:
            $ref: '#/components/schemas/VirtualGPUClusterInterfacePricingSerializer'
          title: Interfaces
          type: array
        name:
          description: Virtual GPU cluster name
          example: poplar-ubuntu
          examples:
            - poplar-ubuntu
          title: Name
          type: string
        volumes:
          description: >-
            Volumes attached to the virtual GPU cluster. Volume size must be
            greater than zero.
          items:
            $ref: >-
              #/components/schemas/VirtualGPUClusterVolumePricingRequestSerializer
          title: Volumes
          type: array
      required:
        - name
        - flavor
        - interfaces
      title: VirtualGPUClusterPricingPreviewRequestSerializer
      type: object
    VirtualGPUClusterPricingPreviewResponseSerializer:
      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/VirtualPricingPerGBSerializer'
            - type: 'null'
          description: Pricing details per category charged per GB.
          examples:
            - egress_traffic_virtual: 1.3
        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
      required:
        - currency_code
        - discount_percent
        - per_hour
        - per_month
        - per_gb
        - price_status
        - price_without_discount_per_month
        - total_price_per_hour
        - total_price_per_month
        - tax_percent
        - discount_details
      title: VirtualGPUClusterPricingPreviewResponseSerializer
      type: object
    VirtualGPUClusterInterfacePricingSerializer:
      discriminator:
        mapping:
          any_subnet:
            $ref: '#/components/schemas/GPUClusterAnySubnetInterfaceSerializer'
          external:
            $ref: '#/components/schemas/GPUClusterExternalInterfaceSerializer'
          subnet:
            $ref: '#/components/schemas/GPUClusterSpecificSubnetInterfaceSerializer'
        propertyName: type
      oneOf:
        - $ref: '#/components/schemas/GPUClusterExternalInterfaceSerializer'
        - $ref: '#/components/schemas/GPUClusterSpecificSubnetInterfaceSerializer'
        - $ref: '#/components/schemas/GPUClusterAnySubnetInterfaceSerializer'
      title: VirtualGPUClusterInterfacePricingSerializer
    VirtualGPUClusterVolumePricingRequestSerializer:
      properties:
        size:
          description: Volume size in GiB. Must be greater than zero.
          example: 1000
          examples:
            - 1000
          exclusiveMinimum: 0
          title: Size
          type: integer
        source:
          const: new-volume
          description: The source of the volume. Only 'new-volume' is supported.
          example: new-volume
          examples:
            - new-volume
          title: Source
          type: string
        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:
        - size
        - source
      title: VirtualGPUClusterVolumePricingRequestSerializer
      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
    VirtualPricingPerGBSerializer:
      properties:
        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: VirtualPricingPerGBSerializer
      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
    GPUClusterAnySubnetInterfaceSerializer:
      properties:
        floating_ip:
          $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer'
          description: >-
            Allows the instance to have a public IP that can be reached from the
            internet. Only new floating IPs are supported.
        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
        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: GPUClusterAnySubnetInterfaceSerializer
      type: object
    GPUClusterExternalInterfaceSerializer:
      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.
        type:
          const: external
          description: A public IP address will be assigned to the instance.
          title: Type
          type: string
      required:
        - type
      title: GPUClusterExternalInterfaceSerializer
      type: object
    GPUClusterSpecificSubnetInterfaceSerializer:
      properties:
        floating_ip:
          $ref: '#/components/schemas/NewInstanceFloatingIpInterfaceSerializer'
          description: >-
            Allows the instance to have a public IP that can be reached from the
            internet. Only new floating IPs are supported.
        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
        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: GPUClusterSpecificSubnetInterfaceSerializer
      type: object
    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
    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
  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

````