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

# 常见问题

> 按主题汇总账户、密钥、调用、计费和功能使用中的高频问题。

本页汇总常见问题。若仍未解决，请参阅 [技术支持](/zh/overview/support)。

## 账户与登录

<AccordionGroup>
  <Accordion title="如何注册账户？">
    访问 [https://moxus.cloud](https://moxus.cloud)，点击右上角登录或注册入口，使用邮箱与验证码完成注册。首次使用流程见 [快速入门](/zh/overview/quickstart)。
  </Accordion>

  <Accordion title="忘记密码如何处理？">
    在登录页面点击“忘记密码”，输入注册邮箱，系统会发送重置链接。按邮件指引设置新密码后即可重新登录。
  </Accordion>

  <Accordion title="是否支持 Google 登录？">
    支持 Google 登录。注册或登录时选择 Google 登录入口，按 Google 授权流程完成后即可进入 Moxus AI。
  </Accordion>

  <Accordion title="如何修改邮箱或密码？">
    登录后进入“个人资料与安全”页面，目前支持修改登录密码和更换绑定邮箱。修改完成后，请使用新的邮箱或密码重新确认登录状态。
  </Accordion>
</AccordionGroup>

## API 密钥

<AccordionGroup>
  <Accordion title="在哪里创建 API 密钥？">
    登录后进入“API 密钥”页面，点击创建密钥。密钥以 `sk-` 开头，完整密钥通常只在创建成功时展示一次。详见 [API 密钥](/zh/platform/account-and-keys)。

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/api-keys-page.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=6558d13e388ff082201fd484d425e7f3" alt="API 密钥页面中的创建入口" width="1495" height="767" data-path="images/api-keys-page.png" />
  </Accordion>

  <Accordion title="可以创建多少把密钥？">
    通常可以创建多把密钥。建议按项目、环境和客户端分别创建，方便设置额度上限、限制模型范围，并在异常时单独作废。
  </Accordion>

  <Accordion title="密钥泄露后怎么办？">
    立即在“API 密钥”页面删除或禁用可疑密钥，然后创建新密钥并更新应用配置。接着到“控制台与用量”页面按时间和密钥排查异常消耗。
  </Accordion>

  <Accordion title="为什么密钥调用某个模型时提示无权限？">
    常见原因包括模型名称填写错误、平台未开放该模型，或创建密钥时限制了可用模型范围。请先在“模型广场”页面核对完整模型名称，再检查密钥设置。
  </Accordion>
</AccordionGroup>

## 运行代码示例

<AccordionGroup>
  <Accordion title="运行 Python 示例前需要安装什么？">
    `openai` 不是 Python 标准库，必须先安装。将 Python 示例保存为 `image_understanding.py` 后，在项目文件夹的终端中依次执行：

    ```bash theme={null}
    python3 -m venv .venv
    source .venv/bin/activate
    python -m pip install openai
    python image_understanding.py
    ```

    这会在项目中创建独立的 `.venv` 环境，确保安装依赖和运行脚本使用同一个 Python。之后再次运行时，先执行 `source .venv/bin/activate`，再执行 `python image_understanding.py`。
  </Accordion>

  <Accordion title="运行 Node.js 示例前需要安装什么？">
    `openai` 不是 Node.js 内置模块。将 Node.js 示例保存为 `image-understanding.mjs` 后，在项目文件夹的终端中执行：

    ```bash theme={null}
    npm install openai
    node image-understanding.mjs
    ```
  </Accordion>
</AccordionGroup>

## 调用与报错

<AccordionGroup>
  <Accordion title="返回 401 认证失败怎么办？">
    通常是密钥错误、缺少 `Bearer ` 前缀、密钥已禁用或已过期。请重新复制密钥，并确认请求头为 `Authorization: Bearer 你的密钥`。
  </Accordion>

  <Accordion title="返回余额不足（insufficient quota）怎么办？">
    账户余额或该密钥的额度上限已用尽。请进入“付款与账单”页面充值，或在“API 密钥”页面调高对应密钥的额度上限。
  </Accordion>

  <Accordion title="提示模型不存在（model not found）怎么办？">
    可能是模型名称大小写、连字符或版本号填写错误，也可能是模型未开放或密钥限制了模型范围。请从“模型广场”页面复制完整模型名称。
  </Accordion>

  <Accordion title="客户端无法获取模型列表怎么办？">
    多数情况与接口地址（Base URL）是否包含 `/v1` 有关。OpenAI 兼容客户端通常填写 `https://moxus.cloud/v1`；如果客户端要求填写“接口域名”，可尝试 `https://moxus.cloud`。
  </Accordion>

  <Accordion title="调用响应缓慢或超时怎么办？">
    可能是模型本身响应较慢、上游服务波动或网络问题。可以更换模型、降低输入长度，或稍后重试。平台会尽量在可用通道间自动重试。
  </Accordion>

  <Accordion title="返回内容被截断怎么办？">
    通常是 `max_tokens` 设置过小，或触发了模型最大输出长度限制。请适当调大 `max_tokens`，并减少不必要的上下文。
  </Accordion>

  <Accordion title="对话提示“temperature is deprecated for this model”或某个参数不支持怎么办？">
    不同模型支持的请求参数不同。在“对话”页面左侧的“参数”区域，取消勾选报错参数名称前的复选框，例如 `Temperature`。取消勾选后，该参数不会随本次请求发送，模型会使用自己的默认行为；发送前也可在 API 代码片段中确认该字段已被移除。

    若仍报错，继续取消勾选错误信息中指出的参数后重试。不要仅调整参数数值，因为模型不支持或已弃用该参数时，任何取值都可能被拒绝。
  </Accordion>
</AccordionGroup>

## 计费

<AccordionGroup>
  <Accordion title="为什么相同问题两次调用费用不同？">
    每次调用的输出长度、上下文长度、缓存命中情况都可能不同，Token 数量也会变化，因此费用可能不同。单次消耗请在“控制台与用量”页面查看。
  </Accordion>

  <Accordion title="如何查询消费明细？">
    单次调用明细在“控制台与用量”页面查看；充值、退款和余额变化在“付款与账单”页面查看；模型单价在“模型广场与定价”页面查看。
  </Accordion>

  <Accordion title="为什么输出价通常高于输入价？">
    内容生成需要模型持续计算后续 Token，通常比读取和理解输入内容成本更高，因此大多数模型的输出单价高于输入单价。
  </Accordion>

  <Accordion title="为什么不同模型价格不同？">
    不同模型的供应商、能力、上下文长度、速度和计费方式不同。请以 [模型广场与定价](/zh/overview/models-and-pricing) 页面展示的当前价格为准。
  </Accordion>
</AccordionGroup>

## 功能与用法

<AccordionGroup>
  <Accordion title="是否支持流式输出？">
    支持。在请求体中设置 `"stream": true` 即可启用流式输出。详见 [流式输出](/zh/guide/streaming)。
  </Accordion>

  <Accordion title="是否支持函数调用？">
    支持，但取决于所选模型是否具备工具调用能力。详见 [函数调用](/zh/guide/function-calling)。
  </Accordion>

  <Accordion title="是否支持返回固定格式的 JSON？">
    支持。可以通过 `response_format` 或模型支持的结构化输出能力约束返回格式。详见 [结构化输出](/zh/guide/structured-output)。
  </Accordion>

  <Accordion title="是否支持图像理解与图像生成？">
    支持，前提是所选模型具备对应能力。可以先在“对话”页面上传图片测试，再接入 API。详见 [视觉与图像生成](/zh/guide/vision-and-image)。
  </Accordion>

  <Accordion title="是否可以使用 Claude 或 Google 官方 SDK？">
    可以。平台兼容 OpenAI、Anthropic 与 Google 三种协议。不同 SDK 的接口地址配置略有差异，详见 [快速入门](/zh/overview/quickstart)。
  </Accordion>
</AccordionGroup>

## 数据与安全

<AccordionGroup>
  <Accordion title="请求内容是否会被保存？">
    平台会记录调用元数据，例如时间、模型、Token 数、费用和状态，用于计费与用量统计。对话内容的具体留存策略以平台隐私政策为准。
  </Accordion>

  <Accordion title="新增模型或充值为什么没有即时生效？">
    模型列表与价格可能存在数分钟缓存，请稍候或刷新页面。充值通常实时到账；若长时间未到账，请通过 [技术支持](/zh/overview/support) 提交支付时间、金额和凭证。
  </Accordion>
</AccordionGroup>