迷雾 AI 使用指南

注册并登录迷雾 AI，准备好余额和 API 密钥后，即可通过 CC Switch 导入配置，开始使用。

💡

【支持除outlook 以外的邮箱】

1. 使用前准备

充值或兑换额度

进入「钱包概览」，确认余额；需要充值时选择金额和可用付款方式，核对后完成支付。有兑换码时，可在钱包下方兑换额度。

钱包概览：查看余额并添加资金

选择模型与分组

打开「模型广场」，查看目标模型所在分组和价格。创建密钥时选择同一分组，模型名称以页面实时列表为准。

模型广场：先确认需要使用的模型与分组

创建 API 密钥

进入「控制台 → API 密钥」，点击右上角「创建 API 密钥」。填写名称，选择刚才确认的分组，按需设置额度和过期时间，点击「保存更改」。

创建 API 密钥入口

选择与目标模型对应的分组

API 密钥用于客户端调用，不是登录密码。「无限配额」仅取消该密钥的额度限制，不代表账号余额无限。截图中的余额、模型和价格仅供操作参考。

2. 通过 CC Switch 一键配置

以下以 Codex 配置截图为例，其他应用请按实际界面选择。

第一步：安装 CC Switch

前往 CC Switch 官网下载并安装适合系统的版本。要接入的客户端也需先安装完成。

第二步：从迷雾导入配置

回到迷雾的「API 密钥」列表，找到刚创建的密钥，点击右侧「填入 CC Switch」图标。

点击密钥右侧的「填入 CC Switch」

选择使用的应用，填写便于识别的配置名称，选择主模型，再点击「打开 CC Switch」。

选择应用、配置名称和主模型

在 CC Switch 弹出的确认窗口核对应用类型、API 端点和模型，点击「导入」。服务地址、API Key 和模型配置会自动填入。

核对配置后点击「导入」

若勾选「导入后立即切换到这个供应商」，后续客户端请求将使用新配置。未勾选时，导入后再切换到该配置。

第三步：获取并选择模型

在 CC Switch 中找到刚导入的配置，点击右侧「编辑」图标。

编辑刚导入的配置

点击「获取模型列表」，查看当前密钥分组可用的模型。

点击「获取模型列表」

勾选需要使用的模型，点击「应用」；返回编辑页，确认默认模型，再点击「保存」。

选择模型后点击「应用」，再保存配置

第四步：重启客户端并验证

保存后，完全退出并重新打开客户端。 以截图中的 Codex 为例，检查输入框旁的模型名称是否为刚才选择的模型，再发送一句简短消息确认可以正常回复。

重启客户端后，检查当前模型名称

如果仍显示旧模型，先确认 CC Switch 中已启用新配置、模型选择已经应用且配置已保存，再重新启动客户端。

3. 手动配置（可选）

先准备以下配置：

配置项	填写方式
服务地址	`https://api.miwuhub.com`
OpenAI 兼容 API Base URL	客户端要求包含版本路径时填写 `https://api.miwuhub.com/v1`
API Key	在「API 密钥」中生成的令牌，不是账号登录密码
模型名称	从模型广场复制的完整名称，且要与令牌分组匹配

不同客户端对地址字段的定义不同。如果字段要求基础域名，填写域名；如果要求 OpenAI SDK 的 base_url，通常填写带 /v1 的地址。检查客户端最终请求路径，避免重复出现 /v1/v1/。不要将完整的 /v1/chat/completions 路径填入仅要求 Base URL 的字段。

3.1 Cherry Studio 等 OpenAI 兼容客户端

在客户端的模型服务设置中添加支持自定义地址的 OpenAI 兼容服务，依次填写上述地址、API Key 和模型名称，保存后进行一次简短对话验证。

客户端菜单以所用版本为准，模型协议以模型广场显示的端点为准。

3.2 开发者请求示例

将模型名替换成分组实际可用的模型，设置环境变量 MIWU_API_KEY 后执行：

示例使用 Bash 语法，执行前需在当前环境设置 MIWU_API_KEY。发送请求可能产生费用。

4. 用量与账单查询

使用日志：进入使用日志，按时间、模型或分组搜索，核对 Token、费用、耗时和错误详情。

充值账单：进入充值账单，按订单号或时间查询支付状态。已付款但未到账时，保留订单号并通过「工单支持」联系平台。

网页测试：也可进入游乐场，选择模型和分组后发送简短问题。模型调用可能产生费用。

5. 常见问题

问题	检查方式
CC Switch 未打开	确认已经安装 CC Switch，并在浏览器弹出提示时选择打开应用
获取模型列表失败	检查服务地址、密钥是否有效，以及密钥分组是否正确
模型列表中没有目标模型	返回模型广场核对分组；不同分组的可用模型可能不同
重启后仍是旧模型	确认新配置处于使用中，模型已应用、配置已保存，再完全退出并重开客户端
提示余额或配额不足	检查钱包余额、密钥额度和过期时间
手动配置时路径错误	检查是否重复拼接 `/v1`，不要把完整接口路径填入仅要求 Base URL 的字段

不要在聊天、截图、公开仓库或工单中展示完整 API Key。联系支持时提供时间、客户端、模型和错误提示即可，必要截图请先遮盖密钥与个人信息。

使用指南

迷雾 AI 使用指南#

1. 使用前准备#

充值或兑换额度#

选择模型与分组#

创建 API 密钥#

2. 通过 CC Switch 一键配置#

第一步：安装 CC Switch#

第二步：从迷雾导入配置#

第三步：获取并选择模型#

第四步：重启客户端并验证#

3. 手动配置（可选）#

3.1 Cherry Studio 等 OpenAI 兼容客户端#

3.2 开发者请求示例#

4. 用量与账单查询#

5. 常见问题#