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

# 几分钟上手咏唱引擎

> 创建咏唱引擎账户、生成 API 密钥，并通过 curl 或 Python 向 REST API 发起你的第一次认证请求。

本快速开始将带你完成注册咏唱引擎、生成 API 密钥并发起首次认证请求的全过程，大约需要五分钟。

## 前置条件

* 任意现代浏览器，访问 `https://ariacompute.cn`（或 `https://ariacompute.com`）。
* 本地安装 `curl` 或 Python 3.8+。

<Steps>
  <Step title="创建账户">
    前往 [ariacompute.cn](https://ariacompute.cn)，使用邮箱与密码、手机号 + 短信验证码，或受支持的 OAuth 提供方（Google、GitHub 或微信）注册。

    <Note>
      Google OAuth 仅在国际站可用。微信 OAuth 在两个站点均可用，但在中国站是首选的 OAuth 方式。
    </Note>
  </Step>

  <Step title="登录并打开 API 密钥">
    打开控制台并导航至 **API 密钥**，地址为 [/dashboard/api-keys](https://ariacompute.cn/dashboard/api-keys)。
  </Step>

  <Step title="创建 API 密钥">
    点击 **创建**，为密钥起一个描述性名称，并复制完整值。密钥以 `bfvk-` 开头，仅展示一次。

    <Warning>
      请将密钥存入密钥管理器。若丢失，请吊销旧密钥并创建新密钥。
    </Warning>
  </Step>

  <Step title="调用 API">
    用户相关接口（如 `/api/auth/me`、`/api/billing/*`）使用会话令牌，网关与模型下载使用 `bfvk-` API 密钥。

    <CodeGroup>
      ```bash curl（会话令牌） theme={null}
      curl -H "Authorization: Bearer eyJhbGciOi..." \
        https://ariacompute.cn/api/auth/me
      ```

      ```bash curl（API 密钥） theme={null}
      curl -L -H "Authorization: Bearer bfvk-XXXXXXXXXXXXXXXX" \
        "https://ariacompute.cn/api/models/gemma-4-e2b-it/download?quant=int4&sdk=v1.0"
      ```

      ```python Python theme={null}
      import requests

      r = requests.get(
          "https://ariacompute.cn/api/auth/me",
          headers={"Authorization": "Bearer eyJhbGciOi..."},
      )
      print(r.status_code, r.json())
      ```
    </CodeGroup>
  </Step>
</Steps>

<Tip>
  如果你使用中国站，请将每个 URL 中的 `ariacompute.com` 替换为 `ariacompute.cn`。钱包与 API 密钥均按站点隔离。
</Tip>

## 下一步

<CardGroup cols={2}>
  <Card title="API 密钥" icon="key" href="/concepts/api-keys">
    了解 `bfvk-` 密钥、轮换与按站点作用域。
  </Card>

  <Card title="下载模型" icon="download" href="/guides/download-models">
    从模型库拉取量化后的 Aria 模型包。
  </Card>

  <Card title="API 参考" icon="code" href="/api-reference/introduction">
    平台接口完整参考。
  </Card>

  <Card title="钱包与计费" icon="wallet" href="/concepts/wallet-billing">
    为预付费余额充值并下载发票。
  </Card>
</CardGroup>