普通用户教程
开始前准备
这一页不是让你写代码，而是先把第一次测试需要的东西准备好。准备越清楚，后面越不容易卡住。
你需要准备什么
| 准备项 | 必须吗 | 怎么确认 |
|---|---|---|
| QQ 邮箱 | 必须 | 当前只能使用 QQ 邮箱注册 Pixel API 账号 |
| Pixel API 站点账号 | 必须 | 用 QQ 邮箱注册成功后能登录控制台 |
| 浏览器 | 必须 | Chrome、Edge、Safari 都可以 |
| 注册赠送测试额度 | 必须确认 | 新账号注册成功后会赠送 0.1 额度，用于第一次连通性测试 |
| 一个可用共享分组 | 必须 | 创建 API Key 时能选到分组 |
| API Key 保存位置 | 必须 | 例如本地记事本、密码管理器，不要公开 |
| 一个测试模型 | 必须 | 从可用渠道或使用密钥弹窗复制 |
| 终端工具 | 可选 | 只在你要用 cURL 时需要 |
| 真实客户端 | 可选 | 跑通网页测试后再接入 |
注册方式限制
当前站点注册只支持 QQ 邮箱。注册成功后，系统会自动赠送 0.1 测试额度；这笔额度只建议用来发送第一条短消息，确认 API Key、分组、Base URL 和模型调用链路能跑通。
不要把密钥发给别人
API Key 相当于你的调用凭证。别人拿到以后，可以用你的余额发请求。不要把完整 sk-... 发到群里、截图里、公开仓库或问题反馈里。
第一次测试建议怎么做
推荐第一次只测试一条最简单的消息：
你好，请只回复：Pixel API 已连接这句话有两个好处：
- 回复很短，花费低。
- 成功与否一眼就能看出来。
不要第一次就发很长的提示词、上传大文件、跑 Agent、接很多插件。先确认链路能通，再做复杂任务。
新手常见误区
| 误区 | 为什么会卡住 | 正确做法 |
|---|---|---|
| 用非 QQ 邮箱注册 | 当前注册规则不支持 | 使用 QQ 邮箱重新注册 |
| 注册后没看余额 | 不知道 0.1 测试额度是否到账 | 先到控制台右上角或钱包页确认余额 |
| 用 0.1 额度跑复杂任务 | 测试额度很快耗尽 | 第一次只发一条短测试消息 |
| 有 API Key，但没有分组 | Key 不知道走哪个号池 | 创建 Key 时选择可用共享分组 |
| 随便填模型名 | 模型名必须被当前分组支持 | 从「可用渠道」或「使用密钥」复制 |
| Base URL 填成官方地址 | 请求没有走 Pixel API | 把官方域名替换成 Pixel API 站点地址 |
| 客户端改完不重启 | 客户端仍读取旧配置 | 改配置后完整退出并重启 |
你要记录哪几样东西
创建过程中建议你临时记录这 4 项：
| 项目 | 示例 | 注意 |
|---|---|---|
| 站点地址 | https://ai-pixel.online | 如果控制台显示不同地址，以控制台为准 |
| API Key 名称 | 我的第一个 Key | 名称不是密钥，只是方便你识别 |
| API Key 内容 | sk-... | 只显示一次或复制一次时要妥善保存 |
| 模型名 | gpt-5.5 | 精确复制，不要多空格 |
下一步
准备好以后，继续看 打开站点并确认余额。