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

# 查询文件配额

> - 查询当前用户的文件使用量与剩余配额
- 默认用户组最多存储 `2000` 个文件

**注意：**
文件接口的 baseURL 为 `https://files-api.evolink.ai`



## OpenAPI

````yaml cn/api-manual/file-series/quota.json GET /api/v1/files/quota
openapi: 3.1.0
info:
  title: 查询文件配额接口
  description: 查询当前用户的文件使用量与剩余配额
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://files-api.evolink.ai
    description: 文件服务环境
security:
  - bearerAuth: []
tags:
  - name: 文件管理
    description: 文件管理相关接口
paths:
  /api/v1/files/quota:
    get:
      tags:
        - 文件管理
      summary: 查询文件配额
      description: |-
        - 查询当前用户的文件使用量与剩余配额
        - 默认用户组最多存储 `2000` 个文件

        **注意：**
        文件接口的 baseURL 为 `https://files-api.evolink.ai`
      operationId: getFilesQuota
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotaResponse'
              example:
                success: true
                code: 200
                data:
                  user_group: default
                  used_files: 35
                  max_files: 2000
                  remain_files: 65
                  is_custom: false
                  quota_reason: ''
components:
  schemas:
    QuotaResponse:
      type: object
      properties:
        success:
          type: boolean
          description: 请求是否成功
          example: true
        code:
          type: integer
          description: 响应状态码
          example: 200
        data:
          $ref: '#/components/schemas/QuotaData'
    QuotaData:
      type: object
      properties:
        user_group:
          type: string
          description: 用户组别：`default`（默认配额 2000 个文件）
          example: default
        used_files:
          type: integer
          description: 当前已存储的文件数量
          example: 35
        max_files:
          type: integer
          description: 最大允许存储的文件数量
          example: 2000
        remain_files:
          type: integer
          description: 剩余可上传的文件数量
          example: 65
        is_custom:
          type: boolean
          description: 是否为管理员手动设置的自定义配额
          example: false
        quota_reason:
          type: string
          description: 自定义配额的原因说明（仅在 `is_custom` 为 `true` 时有值）
          example: ''
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##所有接口均需要使用Bearer Token进行认证##

        **获取 API Key ：**

        访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key

        **使用时在请求头中添加：**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````