> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.joytokens.ai/llms.txt.

# 👋 新手上路

> 从注册到你的第一次 AI 对话，几分钟搞定

欢迎来到 JoyToken!你将学到:

* 如何注册并登录 JoyToken
* 如何获得你的专属钥匙（API Key）
* 如何不用写代码、先体验一次 AI 对话
* 如何查看你的钱包（积分/用量/账单）
* 遇到问题怎么找帮助

🎬 视频演示

2 分钟，从注册到你的第一次 AI 对话

完整版视频：注册登录 → 创建防护策略 → 生成 API Key → 在 API试炼场完成第一次对话，一步不落。

## 第 1 步：注册 / 登录

打开 JoyToken 官网，点击右上角**登录/注册**；使用公司邮箱注册或企业账号登录；登录后按提示完善资料。

## 第 2 步：生成你的专属钥匙（API Key）

钥匙是你的"身份证"，后面所有对话都要靠它认身份。

* 在左侧菜单点「API 密钥」，点右上角「创建新密钥」;
* 在弹出的窗口里填**密钥名称**（给它起个好认的名字，比如"我的第一个 Key"）;
* 设置**过期时间**（可选：永不过期 / 30 天 / 90 天 / 自定义）;
* 绑定一个**防护策略**（没有的话先去「防护策略」菜单创建一个，选一个档位即可）;
* 点「确定」生成，页面会显示一串密钥字符——**立刻复制并妥善保存**，关闭后就不会再完整显示；
* **留意**：每个账号最多同时保留 3 个可用密钥，够用就行。

> **Note**
>
> 💡 **为什么要先建防护策略？** JoyToken 的每个 Key 都必须绑定一个策略（相当于给钥匙配上使用规则：走哪个档位、额度上限、IP 白名单等），所以顺序是：**先建策略 → 再建 Key**。

## 第 3 步：在「API试炼场」体验一次真实对话

钥匙建好后，要先在 API试炼场"验证"它能不能用，然后就能直接对话了。

* 点左侧菜单「API试炼场」;
* 把刚复制的 Key 粘贴进来，点「验证 API Key」；如果从 API 密钥页跳转来，系统会自动识别、无需手动粘贴；
* 看到验证通过（策略、档位显示出来）后，在中间输入框敲一句话，比如「请用三句话介绍你自己」;
* 点「发送」，等一会儿就能看到模型回复，你的第一次 AI 对话就完成了！

## 第 4 步：查看你的钱包（积分/用量/账单）

* 点「总览」，可以看到账户的资源概况，包括 **余额**（所有档位共用一个钱包，也就是你充的钱折算的额度）和用量；
* 想看更细的，点「用量」看 Token 消耗、请求量、延迟；想看充值记录和消费明细，点「账单」;
* 额度不够了，去「充值」页面按需购买套餐即可。

JoyToken 里的"积分"，按 Token 消耗，余额在「总览」就能看到。

## 第 5 步：遇到问题去哪求助

* 遇到操作上的疑问，先翻帮助文档；
* 遇到报错 / Key 失效，优先检查：Key 是否复制完整、是否已经过期、是否超过 3 个限额；
* 还搞不定，就点击「联系我们」，把报错信息一并发送，处理更快。

## 常见问题 FAQ

#### Q1:不会写代码能用吗？

完全能用，打开「API试炼场」像聊天一样直接对话即可，全程零代码。

#### Q2:API Key 是什么？

你的专属钥匙，用来识别身份并归因用量和账单。要保管好，创建后只显示一次，丢了就得重建。

#### Q3:积分是什么？

你充值获得的、调用时按量消耗的用量钱包，余额在「总览」查看，用完了到「去充值」页面购买。

#### Q4:第一步该做什么？

注册 → 完善资料 → 创建防护策略 → 创建 API Key（复制保存）→ 打开 API试炼场验证 Key → 输入一句话看回复。