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

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# 查询文件配额

> GET /api/v1/files/quota · 查询当前用户的文件使用量与剩余配额

> * 默认用户组最多存储 **2,000** 个活跃文件
> * 返回当前用户的已存储文件数 (`used_files`) 与剩余可用额度 (`remain_files`)
> * 鉴权：`Authorization: Bearer sk-...`

## 响应字段

| 字段             | 类型      | 说明                           |
| -------------- | ------- | ---------------------------- |
| `user_group`   | string  | 当前用户所在分组（如 `default`、`auto`） |
| `used_files`   | integer | 当前用户已保存的活跃（未过期）文件数           |
| `max_files`    | integer | 当前用户允许存储的最大文件数（默认 2000）      |
| `remain_files` | integer | 剩余可上传文件数                     |
| `is_custom`    | boolean | 是否为定制配额                      |
| `quota_reason` | string  | 配额原因说明（若有）                   |

## 响应示例

```json theme={null}
{
  "success": true,
  "code": 200,
  "data": {
    "user_group": "default",
    "used_files": 2,
    "max_files": 2000,
    "remain_files": 1998,
    "is_custom": false,
    "quota_reason": ""
  }
}
```