# 控制台总览

控制台 **[api.clomio.ai](https://api.clomio.ai)** 是你管理密钥、查用量、充值、提工单的地方。本页总览各功能,详细的另有分页。

---

## 核心功能

| 功能 | 作用 | 详情 |
|------|------|------|
| **仪表盘** | 登录首页,概览钱包余额、近期用量、公告 | [用量明细 · Dashboard](#/console-usage) |
| **API 密钥** | 创建/管理密钥,设分组、额度、速率、IP、有效期 | [创建 API 密钥](#/api-key) |
| **用量明细** | 看每次调用的模型、token、扣费 | [用量明细](#/console-usage) |
| **订阅与余额** | 两种计费模式、充值、订单、退款、开票 | [订阅与余额](#/console-billing) |
| **邀请·工单·账号** | 邀请返利、提工单、第三方授权绑定 | [邀请、工单与账号](#/console-account) |

### 功能入口覆盖表

| 控制台/用户入口 | 文档位置 | 说明 |
|------|------|------|
| 登录、注册、找回密码、第三方登录/绑定 | [邀请、工单与账号](#/console-account) | 控制台账号认证,不是模型网关 API Key 鉴权 |
| API Key 列表、创建、编辑、删除、分组倍率 | [创建 API 密钥](#/api-key) | 用户侧 `/keys`、`/groups/*`;决定工具能调用哪些公开网关端点 |
| 用量明细、仪表盘趋势、模型统计、错误请求 | [用量明细](#/console-usage) | 控制台查询/排障入口;公开自助对账另见 `GET /v1/usage` |
| 余额充值、订阅套餐、订单恢复、退款、发票 | [订阅与余额](#/console-billing) 与 [计费与额度](#/billing) | 支付/账单控制台功能,以当前支付渠道开关为准 |
| 兑换码、订阅进度、平台额度 | [订阅与余额](#/console-billing) / [计费与额度](#/billing) | 入口可见时使用,额度最终看控制台实时值 |
| 邀请返利、工单、通知邮箱、2FA/TOTP | [邀请、工单与账号](#/console-account) | 如果入口可见,按页面流程操作 |
| 可用渠道、渠道状态/监控、公告 | 本页与 [用量明细](#/console-usage) | 辅助判断线路/模型/维护状态,不是公开模型调用端点 |
| 网页端 AI Studio、图库、提示词 | [AI Studio：网页 AI、图片图库与 Prompt 模板](#/console-ai-studio) | **控制台功能**,不是 OpenAI/Claude/Grok 公开网关 API |
| 技能市场、安装、创作者版本和收益 | [技能市场与创作者中心](#/console-skills) | 控制台网页端技能系统,不要和本地 Codex/Claude Skill 混淆 |

---

## 其他常用入口

- **可用分组 / 分组倍率**:来自用户侧 `/groups/available` 与 `/groups/rates`,用于确认你能把 Key 绑定到哪些分组、平台、倍率和订阅类型。创建 Key 前先确认分组平台是 Claude/OpenAI/Grok/OpenAI-compatible 等。
- **可用渠道**:来自 `/channels/available`,按渠道聚合展示当前可访问分组、支持模型和定价模式。
- **服务状态 / 渠道监控**:来自 `/channel-monitors` 与 `/channel-monitors/{id}/status`,展示当前用户可见渠道的主模型状态、延迟、7/15/30 天可用率和附加模型状态。**用着卡顿时,先看状态、再换[网关线路](#/gateway-lines)或分组。**
- **公告**:来自 `/announcements`,重要变更、维护通知会发在公告区；可标记已读,建议常看。
- **网页端 AI**:若入口可见,控制台内置网页版 AI 对话、绘图、图库、图片编辑和提示词库,详见 [AI Studio：网页 AI、图片图库与 Prompt 模板](#/console-ai-studio)。
- **技能市场**:浏览、安装、创建、发布和运行网页端技能,详见 [技能市场与创作者中心](#/console-skills)。
- **媒体/附件**:控制台上传能力,用于工单附件、网页端 AI 图片等浏览器功能;它不是 OpenAI Files API,也不会让模型网关多出不存在的端点。

> 要在终端用 Claude Code / Codex,仍走 [命令行工具接入](#/claude-code)。

部分功能会受站点开关影响:例如工单、邀请返利、支付渠道、发票、退款、错误请求页、渠道监控、网页端 AI、技能市场等。如果你在文档里看到某入口,但控制台当前没有显示,以控制台实际开放状态为准。

---

## 出问题时先带哪些信息

提交工单或找支持时,优先附上这些信息:

- **Request ID / 错误详情 ID**:成功或计费记录看用量明细里的 `request_id`;用户侧错误请求页是脱敏视图,列表/详情使用错误记录 `id`、`status_code`、`category`、`message`、`key_name` 等字段。
- **Key 名称 / 分组名 / 模型名**:不要直接发送完整密钥。
- **客户端与 Base URL**:例如 Claude Code 使用 `https://api.clomio.ai`,Codex 使用 `https://api.clomio.ai/v1`。
- **时间范围和截图**:方便在用量明细、错误请求、订单、发票、渠道监控或工单记录中定位。
- **控制台问题可附字段**:支付问题带 `out_trade_no`/订单 ID/支付渠道;工单并发编辑问题带 `expected_revision_no` 或 `If-Match`;AI Studio/技能市场问题带页面路由、运行记录 ID、`error_message`。

错误类问题先看 [故障排查](#/troubleshooting);扣费类问题先看 [用量明细](#/console-usage) 和 [计费与额度](#/billing)。

---

## 新手路径

1. [创建 API 密钥](#/api-key)(选对分组)
2. [充值](#/console-billing)(先小额测试)
3. [5 分钟快速开始](#/quickstart)(接上工具)
4. 用着卡顿?换 [网关线路](#/gateway-lines);报错?查 [故障排查](#/troubleshooting)