> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neural4d.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询剩余点数

> 查询后续操作可用的剩余点数。



## OpenAPI

````yaml /openapi.old.zh.json post /api/queryPointsInfo
openapi: 3.0.3
info:
  title: Neural4D 管理接口
  description: Neural4D 管理接口规范，中文界面下使用本规范展示中文接口说明。
  version: 1.5.4
servers:
  - url: https://alb.neural4d.com:3000
    description: 生产环境
security:
  - bearerAuth: []
tags:
  - name: text-to-3d
    description: 用于通过文本生成 3D 模型的接口。
    x-group: 文本生成 3D
  - name: image-to-3d
    description: 用于通过图片生成 3D 模型的接口。
    x-group: 图片生成 3D
  - name: model-management
    description: 用于查询模型、跟踪任务和转换格式的接口。
    x-group: 模型管理
  - name: media-generation
    description: 用于生成图片、视频以及查询结果的接口。
    x-group: 图片与视频生成
  - name: account-and-validation
    description: 用于校验输入图片和查询点数余额的接口。
    x-group: 账户与校验
paths:
  /api/queryPointsInfo:
    post:
      tags:
        - account-and-validation
      summary: 查询剩余点数
      description: 查询后续操作可用的剩余点数。
      operationId: queryPointsInfo
      responses:
        '200':
          description: 剩余点数信息
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryPointsInfoResponse'
              examples:
                success:
                  value:
                    statusType: 0
                    data:
                      total_points: 54335
                      monthly_bonus_points: 0
                      permanent_points: 54335
                      year_points: 0
                      expiration_day: null
                    message: Get the points info successfully
components:
  schemas:
    QueryPointsInfoResponse:
      type: object
      required:
        - statusType
        - data
        - message
      properties:
        statusType:
          type: integer
          enum:
            - -1
            - 0
          description: 查询状态。`0` 表示结果有效，`-1` 表示结果无效。
        data:
          $ref: '#/components/schemas/BalanceInfo'
          description: 按点数类型分组的当前余额。
        message:
          type: string
          description: 可读的点数余额查询结果。
    BalanceInfo:
      type: object
      required:
        - total_points
        - monthly_bonus_points
        - permanent_points
        - year_points
        - expiration_day
      properties:
        total_points:
          type: integer
          description: 账户当前可用的总点数。
        monthly_bonus_points:
          type: integer
          description: 月度套餐赠送的可用点数。
        permanent_points:
          type: integer
          description: 不按月到期的永久可用点数。
        year_points:
          type: integer
          description: 年度套餐赠送的可用点数。
        expiration_day:
          type: string
          nullable: true
          description: 限时点数的到期日，存在时返回。
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 使用 Neural4D 网站提供的 Bearer token。
      x-default: YOUR_TOKEN

````