---
title: 快速开始
description: 用一个账户、一把密钥和一个可用模型完成首次接入。
---

<Steps>
  <Step title="注册并验证邮箱">
    打开 [VC 注册页](https://sub.vcnovb.cn/register)，填写邮箱并完成验证码验证，再登录控制台。
  </Step>
  <Step title="准备额度">
    从[购买渠道](https://sub.vcnovb.cn/purchase)选择商品，按商品说明取得兑换码；在[兑换页面](https://sub.vcnovb.cn/redeem)兑换后检查余额或订阅。
    已有可用额度可跳过此步。
  </Step>
  <Step title="创建 API Key">
    打开 [API 密钥](https://sub.vcnovb.cn/keys)，创建密钥并选择有权限使用的分组。先使用单个分组，便于核对模型和计费。保存并复制密钥。
  </Step>
  <Step title="选择接入方式">
    不写代码可直接进入[对话广场](https://sub.vcnovb.cn/playground)。使用客户端时，在密钥列表打开“使用”配置说明；开发接入可按下方示例查询模型。
  </Step>
</Steps>

## 先查询当前密钥可用模型

<CodeGroup>
```bash macOS / Linux
export VC_API_KEY="替换为你的VC密钥"
curl https://sub.vcnovb.cn/v1/models \
  -H "Authorization: Bearer $VC_API_KEY"
```
```powershell PowerShell
$env:VC_API_KEY = "替换为你的VC密钥"
$headers = @{ Authorization = "Bearer $env:VC_API_KEY" }
Invoke-RestMethod -Uri "https://sub.vcnovb.cn/v1/models" -Headers $headers
```
</CodeGroup>

从返回列表中复制模型 ID，填入下一步请求的 `model` 字段。

## 发起文本请求

以下 Bash 示例使用 `gpt-5.2`。如需其他文本模型，将 `model` 替换为上一步查询到的 ID。

```bash
curl https://sub.vcnovb.cn/v1/chat/completions \
  -H "Authorization: Bearer $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.2","messages":[{"role":"user","content":"你好，请用一句话介绍自己。"}],"stream":false}'
```

<Note>生成请求会按分组规则计费。成功后可在[使用记录](https://sub.vcnovb.cn/usage)查看模型、费用和耗时。API Key 属于账户凭据，不要写进公开代码或发送给他人。</Note>

接下来查看[客户端配置](/guides/clients)、[密钥管理](/guides/keys)或[常见问题](/help/troubleshooting)。