主题
暮色api 新手图文教程
配置 Codex？看 Windows 完整图文流程。充值、套餐与发票见 计费说明、发票申请。
先选你要做的事：
- AI 编程 / 聊天：登录 → 创建并复制密钥 → 配置工具
- API 接入：用自己的代码直接调用
首次使用，先完成第 1、2 步。教程更新：2026 年 10 月 12 日；界面可能随版本调整，模型、价格、支付方式与活动以当前页面为准。
01 · 注册 暮色api 账号
打开 暮色api 首页 ↗，点击 「开始构建」 进入注册；已有账号点击右上角 「登录」。也可直接打开 注册页面 ↗。
- 填写用户名、密码和确认密码。密码按页面提示设置。
- 填写能正常收信的邮箱，点击 「发送验证码」。
- 到邮箱收取验证码并填回页面，再点击 「创建账户」。完成后使用自己的账号登录。
收不到验证码，先检查邮箱地址和垃圾邮件；仍无法收到时联系客服。官方 Q 群有新用户试用领取入口，领取方式与额度以群公告为准。
完成标志： 能够进入控制台，在「个人资料」里查看自己的用户名和用户 ID。
02 · 充值余额，或兑换额度
登录后，在左侧 「个人 → 钱包」 中操作，也可直接打开 钱包 ↗。手机上先展开左上角菜单。
- 在 「添加资金」 里选择金额，或输入自定义金额。
- 核对待支付金额，再选择页面可用的支付宝、微信等支付方式。支付按钮为灰色时，检查是否达到该方式的最低金额。
- 按收银台提示完成支付后返回钱包，确认余额已更新。支付可能跳转到第三方收银台，请核对订单金额。
按订单的精确金额支付。 如果收银台显示 10.01，就支付 10.01，不要自行改成 10。已付款但未到账时，保留订单号和付款截图，联系客服核对，先不要重复付款。
有兑换码： 在同一充值卡片下方的 「有兑换码吗？」 输入兑换码，点击 「兑换额度」。进群领取的试用额度也以兑换码形式发放。不要把兑换码发到群里。
钱包余额和订阅套餐是两种使用方式。 购买订阅前请看套餐支持的分组、每期额度与重置规则；有套餐不代表所有模型都从套餐扣费。
完成标志： 钱包显示可用余额，或已有支持目标分组的有效套餐。详细规则见 充值与订阅套餐。
03 · 为自己的工具创建 API 密钥
使用 Codex、Claude Code、聊天客户端或自己的代码，需要先创建密钥。进入 API 密钥 ↗，点击右上角 「创建 API 密钥」。
填写名称、分组和有效期
- 名称： 用于辨认用途，例如「我的 Codex」。名称不会改变密钥权限。
- 分组： 决定这把密钥能用哪些模型，并影响路由和价格。本站当前使用统一分组，详见 分组与模型选择。
- 过期时间： 按实际使用周期设置；到期后，工具即使保存了正确的 Key，也无法继续调用。
- 额度： 可关闭「无限配额」并设置预算，含义见下方说明。
不确定模型属于哪组，先查看 模型广场 ↗。看不到某个分组，以你的账号实际列表为准。密钥像密码一样保管，不要截图公开或发送给他人。
分组倍率怎么看
在模型广场确认模型的计费方式和当前分组价格。倍率是计费因素之一：假设某次调用在分组倍率生效前的费用为 1 个余额单位，倍率为 0.2，则这部分费用为 0.2 个余额单位。这只是计算示例，不代表本站当前价格。
如果页面已经显示所选分组的最终价格，不要再乘一次倍率。实际费用还可能受输入输出量、缓存命中与模型计费规则影响，以使用日志为准。
密钥额度不等于钱包余额
密钥额度是 这把 Key 最多可用的预算，设置额度不会给钱包充值。例如只走钱包扣费时，钱包剩 10、Key 额度设 100，可用金额仍受钱包的 10 限制；钱包剩 100、Key 剩余额度为 10，这把 Key 则受 10 的限制。示例使用同一种余额单位。
「无限配额」不是免费使用。 它仅取消这把密钥的独立额度上限，仍需有可用钱包余额或适用套餐；套餐还受支持分组、当期额度和扣费偏好限制。
04 · 保存并复制密钥
- 确认名称、分组、有效期和额度，点击 「保存更改」。
- 回到 API 密钥列表，找到刚创建的名称，使用对应的 复制按钮 复制完整 Key。不要复制列表里已隐藏的显示文本。
- 在工具的 API Key 栏粘贴这把密钥，同时填写 暮色api 地址和该分组支持的完整模型 ID。
- 用一句短提示词测试，例如「请只回复 OK」。请求可能产生少量费用，成功后到 使用日志 ↗ 核对模型和费用。
完成标志： 工具能够返回结果，使用日志可查到对应请求。创建多个工具配置时，建议分别使用独立 Key，便于控制预算和停用。
复制后不要发到群里，也不要拍下完整 Key。只修改原密钥的分组通常不需要重新复制，但工具中的模型要与新分组匹配；新建密钥后则需要更新工具配置。
05 · 接入 Codex、Claude Code 或聊天工具
准备好三项：暮色api API Key、接口地址、当前分组可用的模型 ID。复制模型完整名称，避免照抄其他平台的模型名。
| 工具 / 协议 | 接口地址 | 继续操作 |
|---|---|---|
| Codex / OpenAI 兼容工具 | https://musecz.xyz/v1 | Codex CLI 配置 |
| Claude Code / Anthropic 兼容工具 | https://musecz.xyz | Claude Code 配置 |
| OpenClaw | https://musecz.xyz/v1 | OpenClaw 配置 |
Windows 桌面用户可直接看 Windows Codex 图文配置，也可以使用 CC Switch 管理配置。具体字段与协议按对应教程填写；不要重复添加 /v1，不要把控制台登录密码当作 API Key。
06 · 遇到问题先检查这里
- 401 / 密钥无效： 确认复制了完整 Key，没有多余空格，密钥未过期或被禁用。
- 额度不足： 检查钱包余额、密钥额度上限及套餐支持的分组。
- 模型不可用： 核对模型名称、密钥分组与模型广场中的权限。
- 生成时间较长： 先查看日志，避免重复提交造成重复扣费。
- 需要协助： 提供操作页面、模型、报错、发生时间与请求 ID；截图遮住密钥、兑换码和个人资料。