Pixel API
使用指南钱包与商城福利与邀请API 参考帮助支持
普通用户教程

确认 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 URLhttps://ai-pixel.online/v1Codex 等部分 OpenAI SDK 风格配置
完整接口地址https://ai-pixel.online/v1/chat/completionscURL、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/completions

Responses:

https://ai-pixel.online/v1/responses

Models:

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 里。

成功标准

进入下一步前,你应该知道:

  1. 我的站点地址是什么。
  2. 我的 API Key 是什么。
  3. 如果用网页 API 参考,应该填哪个 Base URL。
  4. 如果用客户端,要优先复制「使用密钥」弹窗里的配置。

继续看 在 API 参考里发送第一条消息

本页目录