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

# 查询账号积分

> 查询您的账户剩余积分余额。

<Info>
  获取您账户当前可用的额度余额。
</Info>

### 使用指南

* 使用此端点查询您的当前额度余额
* 监控用量，确保有足够额度以持续使用服务
* 根据您的使用规律合理规划额度补充计划

### 开发者须知

* 所有生成服务均需消耗额度
* 额度耗尽后将限制服务访问
* 额度消耗量取决于具体服务类型及使用量


## OpenAPI

````yaml zh/common-api/get-account-credits.json get /api/v1/client/account/balance
openapi: 3.0.0
info:
  title: 获取剩余额度
  description: 查询您的账户剩余额度余额。
  version: 1.0.0
  contact:
    name: 技术支持
    email: support@crun.ai
servers:
  - url: https://api.crun.ai
    description: API 服务器
security:
  - ApiKeyAuth: []
paths:
  /api/v1/client/account/balance:
    get:
      summary: 查询您的账户剩余额度余额
      operationId: get-account-balance
      responses:
        '200':
          description: 获取成功。
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/ResponseModel'
              example:
                code: 200
                message: success
                data:
                  balance: 1000
        '401':
          description: API Key 缺失
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
              example:
                code: 401
                message: API key missing
                data: null
        '403':
          description: API Key 已禁用
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
              example:
                code: 403
                message: API key disabled
                data: null
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          description: |-
            响应状态码

            - **200**: 成功 - 请求已成功处理
            - **401**: 未授权 - 身份凭证缺失或无效
            - **402**: 额度不足 - 账户余额不足以完成本次操作
            - **404**: 未找到 - 请求的资源或端点不存在
            - **422**: 验证错误 - 请求参数未通过验证
            - **429**: 请求限速 - 该资源的请求次数已超出限制
            - **455**: 服务不可用 - 系统正在维护中
            - **500**: 服务器错误 - 处理请求时发生意外错误
            - **501**: 生成失败 - 内容生成任务失败
            - **505**: 功能已禁用 - 所请求的功能当前已被禁用
        message:
          type: string
          description: 响应消息
        data:
          nullable: true
      required:
        - code
        - message
    ResponseModel:
      type: object
      description: 结果信息。
      properties:
        balance:
          type: number
          description: 账户当前积分余额
          example: 1000
      required:
        - balance
  responses:
    Error:
      description: 服务器错误
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |-
        所有 API 均需通过 API Key 进行身份验证。

        获取 API Key：
        1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取您的 API Key

        使用方式：
        将以下内容添加至请求头：

        x-api-key: YOUR_API_KEY

        注意事项：
        - 请妥善保管您的 API Key，切勿与他人共享
        - 若怀疑 API Key 已泄露，请立即在管理页面进行重置

````