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

# 获取剩余积分

<Info>
  查询您账户中当前可用的积分余额。
</Info>

### 使用指南

* 使用此接口检查您当前的积分余额
* 监控使用情况以确保有足够的积分继续使用服务
* 根据您的使用模式规划积分充值

### 开发者注意事项

* 所有生成服务都需要积分余额
* 当积分耗尽时，服务访问将受到限制
* 积分消耗基于具体服务和使用量


## OpenAPI

````yaml cn/common-api/common-api.json get /api/v1/common/credit
openapi: 3.0.0
info:
  title: 通用 API
  description: NanoBanana API 通用接口文档
  version: 1.0.0
  contact:
    name: 技术支持
    email: support@nanobananaapi.ai
servers:
  - url: https://api.nanobananaapi.ai
    description: API 服务器
security:
  - BearerAuth: []
paths:
  /api/v1/common/credit:
    get:
      summary: 获取账户剩余积分
      operationId: get-account-credits
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 200
                      - 401
                      - 402
                      - 404
                      - 422
                      - 429
                      - 455
                      - 500
                      - 505
                    description: |-
                      响应状态码

                      | 状态码 | 说明 |
                      |------|-------------|
                      | 200 | 成功 - 请求已成功处理 |
                      | 401 | 未授权 - 身份验证凭据缺失或无效 |
                      | 402 | 积分不足 - 账户没有足够的积分来执行操作 |
                      | 404 | 未找到 - 请求的资源或端点不存在 |
                      | 422 | 验证错误 - 请求参数未通过验证检查 |
                      | 429 | 请求限制 - 此资源的请求限制已超出 |
                      | 455 | 服务不可用 - 系统当前正在进行维护 |
                      | 500 | 服务器错误 - 处理请求时发生意外错误 |
                      | 505 | 功能已禁用 - 请求的功能当前已禁用 |
                  msg:
                    type: string
                    description: 当 code != 200 时的错误消息
                    example: success
                  data:
                    type: integer
                    description: 剩余积分数量
                    example: 100
                required:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data: 100
        '500':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: 服务器错误
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |-
        所有 API 都需要通过 Bearer Token 进行身份验证。

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

        使用方法：
        在请求头中添加：
        Authorization: Bearer YOUR_API_KEY

        注意：
        - 请保护您的 API Key 安全，不要与他人分享
        - 如果您怀疑 API Key 已泄露，请立即在管理页面重置

````