> ## 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 File Quota

> GET /api/v1/files/quota · Query current user file quota and remaining slots

> * Users can store up to **2,000** active files
> * Returns current active file count (`used_files`) and available capacity (`remain_files`)
> * Auth: `Authorization: Bearer sk-...`

## Response Fields

| Field          | Type    | Description                                         |
| -------------- | ------- | --------------------------------------------------- |
| `user_group`   | string  | Current token group (e.g. `default`, `auto`)        |
| `used_files`   | integer | Number of active (unexpired) files currently stored |
| `max_files`    | integer | Maximum allowed files (default 2,000)               |
| `remain_files` | integer | Remaining available upload slots                    |
| `is_custom`    | boolean | Whether user has custom quota override              |
| `quota_reason` | string  | Optional description for custom quota               |

## Response Example

```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": ""
  }
}
```
