# 控制台实操场景

控制台 AI Studio、图片图库、Prompt 模板、用量错误详情、工单附件、兑换码、订阅、2FA 与邀请返利的操作模板。

控制台功能以当前页面和站点开关为准；入口不可见时不要假设一定开放。相关说明见 [控制台总览](#/console)、[AI Studio](#/console-ai-studio)、[用量明细](#/console-usage)、[订阅与余额](#/console-billing)、[邀请、工单与账号](#/console-account)。

---

## 错误请求:带 request_id 排查

当客户端返回 4xx/5xx 时,先把这几项保存下来:

- 完整 HTTP 状态码和响应体
- 响应头里的 `x-request-id` / `x-client-request-id`(如果有)
- 你实际使用的 Base URL、端点、模型名、Key 分组
- 发生时间和是否换过线路

最小复现 curl 模板:

```bash
curl -i https://api.clomio.ai/v1/responses \
  -H "Authorization: Bearer 你的 OpenAI/Codex 分组密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"控制台里的模型名","input":"ping","max_output_tokens":1}'
```

把输出里的 request_id 连同报错一起发工单,支持可以按请求精确定位。不要只贴“model not found”截图,也不要在不同 Key/不同线路之间混测后只保留最后一张图。

---

## 控制台内置 AI 聊天:先验证模型再接 CLI

如果控制台里能看到 **AI 聊天** 入口,新手可以先用它做一次最小验证:

1. 选择你准备给 CLI/API 使用的分组和模型。
2. 发送 `ping` 或一句很短的问题。
3. 到「使用记录」确认这次请求有记录、扣费正常、模型名正确。
4. 再把同一个模型名填到 Claude Code、Codex、Grok 或 SDK 配置里。

这样能先排除“余额不足、模型名写错、分组未开放”的问题。详细功能见 [AI Studio：网页 AI、图片图库与 Prompt 模板](#/console-ai-studio)。入口不可见时,直接用 `GET /v1/models` 和最小 curl 验证即可。

---

## 控制台图片、画廊、Prompt 模板:从可见入口开始

如果控制台开放了相关入口,可以这样用:

- **图片生成**:先在控制台选择开放的图片模型试一张图,再把同样的 prompt 和模型迁移到 `/v1/images/*` 或 OpenAI SDK。
- **画廊**:如果有画廊入口,把满意结果保存为参考,后续复用 prompt、尺寸、风格描述。
- **Prompt 模板**:如果有模板入口,先从“代码审查、Bug 定位、文档总结、图片描述”等模板改写,再复制到 CLI。

详情见 [AI Studio：网页 AI、图片图库与 Prompt 模板](#/console-ai-studio);如果要安装或创作网页端技能,见 [技能市场与创作者中心](#/console-skills)。

注意能力边界不变:Images 可用 OpenAI 分组或 Grok 分组;视频能力仅 Grok;Embeddings 走 OpenAI;Web Search 仅 Grok。

---

## 从 Key 弹窗复制到客户端配置

API Key 列表里的「使用 / 复制配置」适合快速生成本机配置，但复制后仍建议用最小 curl 验证协议：

1. 先确认 Key 绑定分组平台：Claude、OpenAI/Codex、Gemini、Antigravity 或 Grok。
2. 打开「使用」弹窗，选择对应 tab：Codex、Codex WS、Claude Code、Gemini CLI、Grok CLI 或 opencode。
3. 把配置写入用户级配置文件或当前 shell；不要把带明文 Key 的配置提交到仓库。
4. 用本文档对应工具页的最小 curl 验证 Base URL、端点和模型。

注意几个容易误解的点：

- OpenAI/Codex 分组默认生成 Codex Responses / WS / opencode；只有该分组开放 Messages 兼容能力时，弹窗才会出现 Claude Code `/v1/messages` 兼容配置。
- Grok 弹窗只生成 Grok CLI env 与 `~/.grok/config.toml`，不代表 Videos 已启用；Videos 仍要用 Grok 视频分组并测 `/v1/videos/generations`。
- Antigravity tab 会按 Claude/Gemini 专用路径生成，不要把 `/v1` 套到 `/antigravity/...` 前缀前面。
- opencode、Hermes、OpenClaw 这类多 provider 客户端请按协议拆 provider，避免一个 Key 同时尝试 Claude Messages、OpenAI Responses 和 Grok Videos。

---

## 用量错误详情 + 工单附件:一次把排查材料带全

如果控制台使用记录能打开错误详情,按这个清单处理:

```text
1. 复制 request_id / x-request-id
2. 复制状态码、错误摘要、模型名、端点
3. 截图保存 Base URL、Key 分组、发生时间
4. 用同一个 Key 和 Base URL 发最小 curl 复现
5. 如果工单入口支持附件,上传截图和 curl -i 输出
```

工单描述模板:

```text
问题: [一句话说明]
时间: [本地时间和时区]
request_id: [从响应头或用量详情复制]
Base URL: [例如 https://api.clomio.ai/v1]
端点: [例如 /v1/responses]
Key 分组: [OpenAI/Codex/Grok/Claude]
模型: [控制台开放模型名]
复现: [最小 curl 或工具命令]
```

有 request_id 时支持能更快定位单次请求;没有时,至少提供发生时间和完整响应体。

---

## 兑换码、订阅、2FA、邀请返利:账户侧操作

这些功能如果在你的控制台入口可见,按页面提示操作即可:

- **兑换码**:在兑换入口输入,提交后回到余额/套餐页确认是否到账。
- **订阅**:选择套餐后看清额度、周期、到期时间和可用分组;实际权益以控制台展示为准。
- **2FA/TOTP**:用认证器 App 扫码,输入 6 位验证码完成绑定;先保存恢复码再开启。
- **邀请返利**:复制邀请链接给新用户;返利比例、结算周期和有效期以入口当前规则为准。

如果入口不可见,不要假设一定有该功能;继续按已开放的 API Key、模型和线路使用即可。

---

> 报错看不懂?把完整截图发给还能用的那个工具继续问;两个都不方便时再借助第三方 AI。排查套路见 [故障排查](#/troubleshooting)。