普通用户教程
确认 Base URL
这一步的目标是:弄清楚请求应该发到哪里。
API Key 解决“你是谁”,Base URL 解决“请求发到哪里”。两者不是一回事。
一句话规则
Pixel API 通常不是让你改接口格式,而是把官方接口的域名替换成 Pixel API 站点地址。
例如官方 OpenAI Chat Completions 地址是:
https://api.openai.com/v1/chat/completions接入 Pixel API 时,通常变成:
https://ai-pixel.online/v1/chat/completions也就是:
官方域名 api.openai.com → Pixel API 域名 ai-pixel.online
接口路径 /v1/chat/completions 保持一致Base URL 和完整地址的区别
| 名称 | 示例 | 用在哪里 |
|---|---|---|
| 站点地址 | https://ai-pixel.online | 大多数网页配置、Claude Code、Gemini CLI |
带 /v1 的 Base URL | https://ai-pixel.online/v1 | Codex 等部分 OpenAI SDK 风格配置 |
| 完整接口地址 | https://ai-pixel.online/v1/chat/completions | cURL、Postman、某些 Endpoint 字段 |
客户端字段名不同,填写方式也可能不同。
客户端让你填 Base URL 时
如果字段叫:
- Base URL
- API Base
- Server URL
- Provider URL
通常填:
https://ai-pixel.online但有些客户端明确要求 OpenAI SDK 的 base_url,可能要填:
https://ai-pixel.online/v1这种情况以 API Key 页面「使用密钥」弹窗给出的配置为准。
客户端让你填 Endpoint 时
如果字段叫 Endpoint、URL、接口地址,并且它要完整地址,就填完整接口。
Chat Completions:
https://ai-pixel.online/v1/chat/completionsResponses:
https://ai-pixel.online/v1/responsesModels:
https://ai-pixel.online/v1/models/v1 到底要不要带
看客户端让你填什么:
| 客户端字段 | /v1 怎么处理 |
|---|---|
Base URL,客户端自己会拼 /v1/chat/completions | 不带 /v1 |
OpenAI SDK 的 base_url | 通常带 /v1 |
| 完整接口地址 | 必须包含完整路径 |
| API Key 页面给出的配置 | 完全照抄 |
如果你不确定,优先照抄「使用密钥」弹窗。
站点地址可能不是固定示例
文档里的示例是:
https://ai-pixel.online如果你的控制台、管理员或「使用密钥」弹窗显示了另一个地址,以实际显示为准。
不要把 API Key 填到 Base URL 里,也不要把 Base URL 填到 API Key 里。
成功标准
进入下一步前,你应该知道:
- 我的站点地址是什么。
- 我的 API Key 是什么。
- 如果用网页 API 参考,应该填哪个 Base URL。
- 如果用客户端,要优先复制「使用密钥」弹窗里的配置。
继续看 在 API 参考里发送第一条消息。