> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速入门

> 本文档说明从账户注册到首次成功调用模型的完整流程。

本文档说明从账户注册到首次成功调用模型的完整流程。

## 流程概览

<Steps>
  <Step title="注册并登录账户">
    访问 `https://moxus.ai`，使用邮箱验证码或平台已启用的第三方登录方式完成注册。
  </Step>

  <Step title="准备可用额度">
    通过新用户赠送、在线充值或兑换码获得调用额度。
  </Step>

  <Step title="创建 API 密钥">
    在 API 密钥页面创建以 `sk-` 开头的密钥，并按用途设置额度上限、过期时间和可用模型范围。
  </Step>

  <Step title="选择模型名称">
    在模型广场查询模型名称，例如 `gpt-4o`、`claude-3-5-sonnet`、`deepseek-chat` 或 `gemini-2.5-pro`。
  </Step>

  <Step title="发起首次调用">
    使用 cURL、SDK 或体验场完成首次请求，并在用量日志中确认记录。
  </Step>
</Steps>

<Warning>
  API 密钥只在创建时完整展示。请立即复制并妥善保存，不要写入前端代码、公开仓库或聊天记录。
</Warning>

## 第一步：注册账户

1. 访问平台首页 `https://moxus.ai`。
2. 点击页面右上角的登录/注册入口。
3. 在注册页面填写邮箱与密码，并完成邮箱验证码校验。
4. 提交后完成注册。

若平台已启用第三方登录（如 GitHub、Discord、OIDC 等），注册页面将显示相应入口，可用于快捷登录。

## 第二步：登录控制台

使用邮箱与密码登录。登录后进入控制台（Dashboard），可查看账户余额、消费趋势及用量统计等信息。

## 第三步：获取额度

调用模型将消耗账户额度，因此需先确保账户有可用余额。获取额度的方式包括：

* 新用户赠送：部分平台向新注册用户发放体验额度。
* 在线充值：在钱包（Wallet）页面选择金额与支付方式完成充值。
* 兑换码：在兑换码页面输入兑换码，额度将充入账户。

详见 [付款与账单](/zh/platform/billing)。

## 第四步：创建 API 密钥

API 密钥是调用接口的身份凭证。

1. 进入 API 密钥（Keys）页面。
2. 点击创建密钥。
3. 填写密钥信息，可配置的项包括：
   * 名称：用于标识密钥用途。
   * 额度上限：限制该密钥可消耗的最大额度。
   * 过期时间：到期后密钥自动失效。
   * 可用模型范围：限制该密钥可调用的模型。
4. 创建成功后，系统将显示以 `sk-` 开头的密钥字符串。请立即复制并妥善保存。部分平台仅在创建时完整显示一次密钥。

API 密钥等同于账户余额的使用权限，应妥善保管，不得泄露、写入前端代码或提交至公开代码仓库。密钥一旦泄露，应立即删除并重新创建。

## 第五步：查询模型名称

1. 进入模型广场（定价）页面。
2. 通过筛选条件查找所需模型。
3. 记录目标模型的名称，例如 `gpt-4o`、`claude-3-5-sonnet`、`deepseek-chat`、`gemini-2.5-pro`。

模型名称在请求中须原样填写，区分大小写与连字符。详见 [模型与定价](/zh/overview/models-and-pricing)。

## 第六步：发起首次调用

### 方式一：网页端测试

进入体验场（Playground），选择模型并输入内容即可查看响应，无需编写代码。详见 [体验场](/zh/platform/playground)。

### 方式二：命令行或 SDK 调用

将以下示例中的 `sk-你的密钥` 替换为实际 API 密钥后执行：

<CodeGroup>
  ```bash theme={null}
  curl https://moxus.ai/v1/chat/completions \
    -H "Authorization: Bearer sk-你的密钥" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-4o",
      "messages": [
        {"role": "user", "content": "请用一句话介绍你自己"}
      ]
    }'
  ```

  ```python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="sk-你的密钥",
      base_url="https://moxus.ai/v1",
  )

  resp = client.chat.completions.create(
      model="gpt-4o",
      messages=[
          {"role": "user", "content": "请用一句话介绍你自己"},
      ],
  )

  print(resp.choices[0].message.content)
  ```
</CodeGroup>

调用成功时，模型输出位于 `choices[0].message.content` 字段，`usage` 字段记录本次调用的 Token 消耗。

<Tip>
  如果你已经在项目中使用 OpenAI SDK，只需要把 `base_url` 或 `baseURL` 改成 `https://moxus.ai/v1`，再替换 API Key。
</Tip>

## 验证调用记录

调用成功后，在用量日志（Usage Logs）页面可查看本次调用的记录，包括所用模型、输入与输出 Token 数量及消耗额度。该记录的出现表明整个调用流程已正常打通。

## 首次调用常见错误

| 现象                   | 原因                         | 处理方式             |
| -------------------- | -------------------------- | ---------------- |
| `401 Unauthorized`   | 密钥错误、缺少 `Bearer ` 前缀或密钥已禁用 | 检查并重新填写密钥        |
| `insufficient quota` | 账户或密钥额度已用尽                 | 前往钱包充值           |
| 模型不存在或无访问权限          | 模型名称错误，或分组/密钥无权限           | 在模型广场核对模型名称      |
| 连接超时                 | 域名错误或网络异常                  | 检查 Base URL 是否正确 |

更多问题参见 [常见问题](/zh/overview/faq)。

## 后续步骤

* 了解认证机制：参阅 [认证](/zh/guide/authentication)。
* 实现流式输出：参阅 [流式输出](/zh/guide/streaming)。
* 使用第三方客户端：参阅 [第三方客户端接入](/zh/integrations/clients)。