慕乐云 API 激活与使用教程

这是一篇面向第一次使用 API 中转服务用户的开篇教程。读完后，你将完成慕乐云账号注册、购买订阅或充值、创建 API 密钥、检查渠道状态，并知道出现 Codex 常见错误时应该从哪里开始排查。

开始前先了解三个信息

后续接入任何 OpenAI 兼容客户端，通常都离不开下面三个信息：

一、打开慕乐云并注册

打开 慕乐云 API 调度中心。已有账号的用户可以直接登录；没有账号时，点击登录框下方的“注册”。

图 1：慕乐云登录页面，未注册用户点击下方“注册”

在注册页面填写邮箱并创建密码，然后按照页面提示完成验证。

图 2：创建一个新的慕乐云账号

二、购买订阅或充值余额

首次登录后，点击左侧的“充值中心”。根据自己的使用方式购买订阅套餐或充值余额，然后按页面提示完成支付。

图 3：在充值中心选择套餐或余额充值包

截图中的金额和优惠只是示例，实际价格、倍率、支付方式和到账额度以网站实时展示为准。支付完成后，先确认页面右上角余额或“我的订单”中的状态已经更新，再继续创建密钥。

三、创建 API 密钥

点击左侧的“API 密钥”，进入密钥管理页面，然后点击右上角“创建密钥”。

图 4：进入 API 密钥页面，点击右上角“创建密钥”

在弹窗中填写一个容易识别的名称，例如“我的 Codex”，再选择准备使用的模型分组并点击“创建”。

图 5：填写名称并选择模型分组，其他高级选项可按需设置

不同分组之间的倍率、稳定性、模型类型和可用能力可能不同，具体以创建页面的实时说明为准。新手第一次创建时，可以先保持高级选项默认；需要控制消费时，再设置额度限制和有效期。

创建成功后请完成三件事：

1. 复制并妥善保存完整 API Key。
2. 确认密钥状态为“活跃”，并记住选择的模型分组。
3. 不同软件尽量使用不同密钥，后续停用和排查会更方便。

图 4 中显示的是打码后的测试密钥，不能复制使用。你必须在自己的账号中创建密钥。

四、检查渠道状态

在接入软件或排查问题前，可以先点击左侧的“渠道状态”，查看最近各个渠道的可用率、请求成功率和首字延迟。

图 6：渠道状态页面可查看可用率、成功率和延迟

• 显示“正常”表示最近探测可用，但不代表每次请求都不会波动。
• 首字延迟越低，通常代表开始输出内容越快。
• 某个分组异常时，可以等待恢复或切换到密钥允许使用的其他分组。
• 提交问题前，建议同时查看“请求日志”，记录状态码、时间和请求 ID。

五、模型 ID 列表

常用模型 ID 示例：

gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-5.2

模型 ID 必须完整匹配，大小写、数字和短横线都不能写错。例如 gpt5.4、GPT-5.4 都不是 gpt-5.4。

六、调用前的连通性测试

在配置 CC Switch、Cockpit Tools 或 Codex 之前，建议先用终端测试一次接口。这样可以快速区分“密钥或服务问题”和“客户端配置问题”。

运行前需要替换：

• your-api-key：换成自己的完整 sk- 密钥，并保留 Bearer。
• gpt-5.4-mini：如果当前分组不支持，请换成控制台中可用的模型 ID。

Windows PowerShell

curl.exe "https://www.mlyapi.com/v1/responses" `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer your-api-key" `
  --data-raw '{"model":"gpt-5.4-mini","input":[{"role":"user","content":[{"type":"input_text","text":"你好"}]}],"store":false,"stream":false}'

Linux / macOS

curl https://www.mlyapi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "gpt-5.4-mini",
    "input": [
      {
        "role": "user",
        "content": [
          {"type": "input_text", "text": "你好"}
        ]
      }
    ],
    "store": false,
    "stream": false
  }'

能够返回 JSON 响应，说明域名、密钥和模型基本配置正确。不要把测试中使用的真实 Key 连同终端截图一起公开。

七、Codex 常见错误排查

Codex 的常见使用场景包括 Visual Studio Code 等 IDE 中的 Codex 插件、Codex CLI 和 Codex App。下文统一简称为 Codex 应用，其他兼容应用也可以参考相同思路。

遇到问题时，先按下面的顺序检查：

1. 渠道状态是否正常。
2. Base URL 是否为 https://www.mlyapi.com/v1。
3. API Key 是否完整、有效并属于正确分组。
4. 模型 ID 是否在当前分组中可用。
5. 重新运行上面的 curl 连通性测试。

Stream disconnected 连接错误

如果出现：

Stream disconnected before completion: stream closed before response.completed

优先检查 base_url 是否为：

https://www.mlyapi.com/v1

如果只写了 https://www.mlyapi.com，请补上 /v1。如果出现：

Stream disconnected before completion: error sending request for url (https://www.mlyapi.com/v1/responses)

通常是本地网络、代理节点或 TLS 连接中断。先运行本文的 curl 测试，再依次尝试切换代理节点、临时关闭代理或更换网络。curl 也无法连接时，问题通常不在 Codex 配置文件。

503 Service Unavailable

Unexpected status 503 Service Unavailable: 所有渠道不可提供当前模型，请稍后重试

常见原因：

• 模型 ID 写错，例如写成 gpt5.4 或 GPT-5.4。
• API Key 所选分组中的目标渠道暂时不可用。
• 慕乐云或上游服务正在维护。
• 上游模型服务出现临时异常。

先查看渠道状态并核对模型 ID，稍后重试。持续出现时，记录发生时间、模型 ID 和请求 ID 后再反馈。

401 Unauthorized

Unexpected status 401 Unauthorized: API Key 无效，请检查后重试

依次检查：

• auth.json 中的 OPENAI_API_KEY 是否为完整密钥，通常以 sk- 开头。
• Key 前后是否多了空格、引号或换行。
• Key 是否已过期、被禁用或被删除。
• 保存配置后是否重启了 Codex 应用。
• auth.json 是否残留其他登录方式生成的字段。

最简 auth.json 示例：

{
  "OPENAI_API_KEY": "your-api-key"
}

config.toml 中的 model_provider 必须放在顶层，并与 provider ID 完全一致：

model = "gpt-5.4"
model_provider = "mlyapi"
model_reasoning_effort = "xhigh"

[model_providers.mlyapi]
name = "MlyAPI"
base_url = "https://www.mlyapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true

不要把 model_provider 错误地写进 [sandbox_workspace_write] 区块中，也不要让 model_provider 的值与 [model_providers.xxx] 中的 xxx 不一致。

403 Forbidden

Unexpected status 403 Forbidden: 余额和订阅额度均不足，请充值后再使用

检查账号余额、订阅额度以及密钥额度限制，充值或续订后重试。

Unexpected status 403 Forbidden: API Key 熔断已开启，请稍后重试

通常表示该密钥连续重试失败次数过多。先解决模型或渠道问题，再前往 API 密钥页面恢复熔断。

499 Client Closed Request

499 通常表示客户端在服务端返回完成前主动关闭了连接：

• 用户手动中断了当前任务，这种情况通常无需处理。
• Codex 或代理检测到超时后断开连接，可以增大超时时间、降低并发后重试。
• 频繁出现时，记录请求时间并对照请求日志检查服务端是否仍在处理。

400 Bad Request

{
  "error": {
    "message": "设定的思维等级不被支持，请修改后重试",
    "type": "invalid_request_error",
    "code": "bad_request"
  }
}

表示当前模型不支持所设置的思维强度。删除该配置或改为模型支持的值。

{
  "error": {
    "message": "请求包含不允许的内容，请修改后重试",
    "type": "invalid_request_error",
    "code": "bad_request"
  }
}

表示请求内容触发了安全限制。修改输入内容后再试，不要尝试绕过平台或上游服务的安全规则。

429 Too Many Requests

exceeded retry limit, last status: 429 Too Many Requests

通常表示 Session 并发数、RPM 或其他速率限制已达到上限。不要在短时间内开启过多并发连接，等待当前请求结束后再试，并避免客户端进行无间隔重试。

502 Bad Gateway

An error occurred while processing your request. You can retry your request.

FAKE_200_JSON_ERROR_MESSAGE_NON_EMPTY: stream_read_error

通常是上游服务或流式传输出现临时异常。先直接重试；仍然失败时，新建 Session、切换当前可用渠道，并查看渠道状态和请求日志。

反馈问题时需要提供什么

由于人工支持可能无法实时回复每条消息，建议先完成上述排查。仍无法解决时，请提供：

• 使用的客户端名称和版本，例如 Codex CLI 或 Codex App。
• 操作系统、网络环境以及是否使用代理。
• 完整状态码、错误正文、发生时间和请求 ID。
• 使用的模型 ID、Base URL 和密钥分组。
• 已打码的配置截图或日志。

接下来学什么

完成本篇后，你已经拥有可用的慕乐云账号、余额或订阅以及 API Key。后续文档将按工具拆分，逐步补充：

• 使用 CC Switch 管理中转服务并接入 Codex。
• 使用 Cockpit Tools 配置和切换模型渠道。
• Codex CLI、Codex App 与 IDE 插件直连慕乐云。
• Chat Completions、Responses API 和其他 OpenAI 兼容客户端示例。

参考资料

• 慕乐云 API 调度中心
• 鱼鱼 API 激活与使用指导
• FlameAPI 文档

本文根据慕乐云当前界面整理。页面名称、价格、模型、分组和渠道状态可能调整，实际信息以网站实时展示为准。