普通用户教程
发送第一条消息
这一步不用装任何东西,直接在文档里把请求发出去。
先在网页里测有个好处:通了就说明账号、余额、分组、API Key、Base URL、模型这一整条链路都没问题。之后客户端不通时,你就能直接锁定是客户端配置的事,不用从头猜。
准备四个值
打开 ChatCompletions 格式,页面里有请求说明、参数和在线请求面板。
填之前先把这四个值凑齐:
| 要填什么 | 例子 | 从哪来 |
|---|---|---|
| Base URL | https://ai-pixel.online | 「使用密钥」弹窗或控制台 |
| API Key | sk-... | API Key 列表复制 |
| 模型名 | gpt-5.5 | 「可用渠道」或「使用密钥」弹窗 |
| 测试消息 | 你好,请只回复:Pixel API 已连接 | 直接复制下面那段 |
填进面板,点 Send
Base URL填控制台显示的站点地址。- 展开
Authorization或认证区域,填入sk-...。 - 在
Request Body里把model改成你能用的模型。 - 把消息内容换成:
你好,请只回复:Pixel API 已连接- 点
Send。
成功的话,返回区里会出现"Pixel API 已连接"。页面显示的是 JSON 的话,看 choices 里的文本内容。
会用终端的话,等价的 cURL 是:
curl "https://ai-pixel.online/v1/chat/completions" \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "你好,请只回复:Pixel API 已连接"
}
]
}'记得把域名换成控制台显示的地址、sk-你的密钥 换成真的 Key、gpt-5.5 换成你分组支持的模型。
失败了先看状态码,别急着改配置
最容易犯的错是一失败就把所有配置都改一遍,结果越改越乱。先看返回的状态码和错误文字,它已经告诉你是哪一层的问题了:
| 状态码 | 最可能的原因 | 先做什么 |
|---|---|---|
| 401 | Key 没填、填错,或缺 Bearer | 回 API Key 页重新点复制按钮 |
| 403 | 分组权限、IP 限制或余额不满足 | 检查 Key 的分组、IP 限制、余额 |
| 404 | 接口路径错了 | 用 /v1/chat/completions |
| 429 | 并发或速率超了 | 降低频率,等几十秒再试 |
| 模型不存在 | 模型名不属于当前分组 | 回「可用渠道」重新复制 |
| 余额不足 | 账户没钱了 | 小额充值后重试 |
每种情况的详细处理见常见问题处理。
下一步:查看使用记录,确认平台也记下了这次请求。