> ## Documentation Index > Fetch the complete documentation index at: https://ppio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 查询产品列表 ## OpenAPI ````yaml gpus/v2-spec/list-gpu-products.json GET /gpus/v2/products openapi: 3.0.0 info: title: PPIO GPU API v2 version: 2.0.0 servers: - url: https://api.ppio.com security: [] paths: /gpus/v2/products: get: summary: 查询产品列表 parameters: - name: Authorization in: header required: true schema: type: string description: Bearer 身份验证格式,例如:Bearer `{{API 密钥}}`。 - name: type in: query required: true schema: type: string description: 产品类型,留空时按 `gpu` 处理。可选值:`gpu`、`cpu`。 example: gpu - name: category in: query required: true schema: type: string description: 产品分类。可选值:`serverless`、`instance`。 example: instance - name: cpu in: query required: false schema: type: integer description: CPU 核数档位。整数,取值 >= 0。 - name: memory_gb in: query required: false schema: type: integer description: 内存档位。整数,取值 >= 0。单位为 GB。 - name: rootfs_size in: query required: false schema: type: integer description: 系统盘大小。整数,取值 >= 0。单位为 GB。 - name: billing_method in: query required: false schema: type: string description: 计费方式。可选值:`postpaid`、`prepaid`、`spot`。 - name: region_ids in: query required: false schema: type: string description: 多区域过滤,多个 Region ID 用英文逗号分隔。 example: c-east-1 - name: limit in: query required: false schema: type: integer description: 本次返回数量上限。整数,取值 >= 0。 - name: cursor in: query required: false schema: type: string description: 上一页响应返回的游标,首次请求留空。字符串,长度限制:0-1024 字符。 responses: '200': description: 查询成功 content: application/json: schema: type: object properties: data: type: array description: 产品列表 items: type: object properties: id: type: string description: 产品 ID example: prod-a100-80g name: type: string description: 产品名 example: A100-80G type: type: string description: 产品类型,可选值:`gpu`、`cpu` example: gpu category: type: string description: 产品分类,可选值:`serverless`、`instance` example: instance description: type: string description: 产品描述 example: NVIDIA A100 80GB region_ids: type: array items: type: string description: 产品所属的区域列表 example: - c-east-1 resource_spec: type: object description: 资源规格(GPU / CPU / 内存 / 系统盘) properties: gpu: type: object nullable: true description: GPU 资源,CPU 产品该字段为 null 或缺省 properties: spec_id: type: string description: GPU 规格 ID example: spec-a100-80g name: type: string description: GPU 型号名 example: A100 memory_gb: type: integer description: 单卡显存,单位为 GB example: 80 min: type: integer description: 可选最小 GPU 数 example: 1 max: type: integer description: 可选最大 GPU 数 example: 8 available: type: integer description: 当前最优节点上的可用 GPU 数(实时) example: 6 max_available: type: integer description: 候选节点中单台最大可分配 GPU 数(实时) example: 6 cpu: type: integer description: CPU 核数 example: 16 memory_gb: type: integer description: 内存大小,单位为 GB example: 128 rootfs: type: object description: 系统盘规格 properties: min_gb: type: integer description: 系统盘最小容量,单位为 GB example: 50 max_gb: type: integer description: 系统盘最大容量,单位为 GB example: 500 free_gb: type: integer description: 基础价内包含的免费额度,单位为 GB example: 50 pricing: type: object description: 价格信息(实例价 + 存储价统一结构) properties: precision: type: integer description: 价格精度,价格相关字段的小数位数 example: 3 postpaid: type: object nullable: true description: 按量付费价格,不支持时为 null。Serverless 产品使用本结构表达规格价格 properties: base_price: type: integer description: 原价 example: 18000 final_price: type: integer description: 实付价。Serverless 中对应原 `discount` 字段 example: 12600 unit: type: string description: 计价单位,例如 `per_hour` example: per_hour spot: type: object nullable: true description: 抢占式价格,不支持时为 null properties: base_price: type: integer description: 原价 example: 12600 final_price: type: integer description: 实付价 example: 6000 unit: type: string description: 计价单位,例如 `per_hour` example: per_hour prepaid: type: array description: 包年包月价格档位 items: type: object properties: spec_id: type: string description: 计费规格 ID example: spec_a100_1m duration_months: type: integer description: 包月时长,单位为月 example: 1 final_price: type: integer description: 该档位的实付价格 example: 9072000 base_price: type: integer description: 该档位的原价 example: 12960000 storage_price_per_gb: type: integer description: 每 GB 存储价格。实例产品使用 example: 50 billing_methods: type: array items: type: string description: 支持的计费方式,取值:`postpaid`、`prepaid`、`spot` example: - postpaid - prepaid - spot inventory_state: type: string description: >- 库存状态。可选值:`none`(无库存)、`low`(库存紧张)、`normal`(库存正常)、`high`(库存充足) example: normal deployable: type: boolean description: 是否可部署。存在可承载本次下单的最优节点时为 true example: true activity: type: object description: 活动信息 properties: is_activity_product: type: boolean description: 是否为活动产品 example: false active: type: boolean description: 活动是否在生效时间窗口内 example: false purchasable: type: boolean description: 是否可购买 example: true ````