本文档说明从账户注册到首次成功调用模型的完整流程。
流程概览
注册并登录账户
访问 https://moxus.ai，使用邮箱验证码或平台已启用的第三方登录方式完成注册。
准备可用额度
通过新用户赠送、在线充值或兑换码获得调用额度。
创建 API 密钥
在 API 密钥页面创建以 sk- 开头的密钥，并按用途设置额度上限、过期时间和可用模型范围。
选择模型名称
在模型广场查询模型名称，例如 gpt-4o、claude-3-5-sonnet、deepseek-chat 或 gemini-2.5-pro。
发起首次调用
使用 cURL、SDK 或体验场完成首次请求，并在用量日志中确认记录。
API 密钥只在创建时完整展示。请立即复制并妥善保存，不要写入前端代码、公开仓库或聊天记录。
第一步：注册账户
- 访问平台首页
https://moxus.ai。
- 点击页面右上角的登录/注册入口。
- 在注册页面填写邮箱与密码，并完成邮箱验证码校验。
- 提交后完成注册。
若平台已启用第三方登录（如 GitHub、Discord、OIDC 等），注册页面将显示相应入口，可用于快捷登录。
第二步：登录控制台
使用邮箱与密码登录。登录后进入控制台（Dashboard），可查看账户余额、消费趋势及用量统计等信息。
第三步：获取额度
调用模型将消耗账户额度，因此需先确保账户有可用余额。获取额度的方式包括：
- 新用户赠送：部分平台向新注册用户发放体验额度。
- 在线充值：在钱包（Wallet）页面选择金额与支付方式完成充值。
- 兑换码：在兑换码页面输入兑换码，额度将充入账户。
详见 付款与账单。
第四步：创建 API 密钥
API 密钥是调用接口的身份凭证。
- 进入 API 密钥（Keys）页面。
- 点击创建密钥。
- 填写密钥信息，可配置的项包括：
- 名称：用于标识密钥用途。
- 额度上限：限制该密钥可消耗的最大额度。
- 过期时间：到期后密钥自动失效。
- 可用模型范围：限制该密钥可调用的模型。
- 创建成功后，系统将显示以
sk- 开头的密钥字符串。请立即复制并妥善保存。部分平台仅在创建时完整显示一次密钥。
API 密钥等同于账户余额的使用权限，应妥善保管，不得泄露、写入前端代码或提交至公开代码仓库。密钥一旦泄露，应立即删除并重新创建。
第五步：查询模型名称
- 进入模型广场（定价）页面。
- 通过筛选条件查找所需模型。
- 记录目标模型的名称，例如
gpt-4o、claude-3-5-sonnet、deepseek-chat、gemini-2.5-pro。
模型名称在请求中须原样填写，区分大小写与连字符。详见 模型与定价。
第六步：发起首次调用
方式一：网页端测试
进入体验场（Playground），选择模型并输入内容即可查看响应，无需编写代码。详见 体验场。
方式二：命令行或 SDK 调用
将以下示例中的 sk-你的密钥 替换为实际 API 密钥后执行：
curl https://moxus.ai/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "请用一句话介绍你自己"}
]
}'
choices[0].message.content 字段，usage 字段记录本次调用的 Token 消耗。
如果你已经在项目中使用 OpenAI SDK，只需要把 base_url 或 baseURL 改成 https://moxus.ai/v1，再替换 API Key。
验证调用记录
调用成功后，在用量日志（Usage Logs）页面可查看本次调用的记录，包括所用模型、输入与输出 Token 数量及消耗额度。该记录的出现表明整个调用流程已正常打通。
首次调用常见错误
| 现象 | 原因 | 处理方式 |
|---|
401 Unauthorized | 密钥错误、缺少 Bearer 前缀或密钥已禁用 | 检查并重新填写密钥 |
insufficient quota | 账户或密钥额度已用尽 | 前往钱包充值 |
| 模型不存在或无访问权限 | 模型名称错误，或分组/密钥无权限 | 在模型广场核对模型名称 |
| 连接超时 | 域名错误或网络异常 | 检查 Base URL 是否正确 |
后续步骤
