Pixel API 文档

API Key 是用户调用网关的入口凭证。

妥善保存密钥

避免密钥出现在日志、截图或公开仓库中。泄漏后应立即删除并重建。

创建流程

登录用户控制台。
进入“API Keys”。
设置名称。
选择你有权限、页面显示可用的 XXX 共享分组。
如需自动回落，开启多分组路由并设置优先级。
创建后复制密钥，或点击导入到 CC-Switch。

分组选择

API Key 需要绑定分组。常见选择：

分组	建议
`XXX 共享分组`	普通用户日常调用，按页面可用权限选择
`XXX 兜底分组`	主共享分组不可用时回落使用
私有分组	调用自己托管的私有账号

私有分组只对账号本人可见。从私有分组调用自己的账号时，会按私有号池策略计算维护成本。

多分组路由

多分组路由用于增强稳定性。开启后，当一个分组被视为不可用，请求会尝试下一个优先级的分组。

示例：

低成本 XXX 共享分组。
主力 XXX 共享分组。
XXX 兜底分组。

优先级数字越小越先调用。如果存在私有号池，也可以把私有分组放入路由策略中。

请求认证

OpenAI/Anthropic 兼容端点使用 Bearer Token：

Authorization: Bearer sk-your-key

Gemini 原生兼容端点也支持部分 SDK 常用方式，例如 query 参数：

GET /v1beta/models?key=sk-your-key

优先使用请求头，方便统一审计与代理。

IP 限制

如果管理员开启或用户配置了 IP 白名单/黑名单，请确认调用方出口 IP 固定。变更代理、CDN 或服务器后，先用低风险请求验证。

常见错误

状态	含义	处理方式
401	未提供密钥或密钥无效	检查 Authorization 头和密钥内容
403	权限、分组或 IP 策略不允许	检查分组、过期、额度和 IP 配置
429	触发限速或并发限制	降低并发或联系管理员调整限额
500/502	上游或网关异常	查看请求 ID，并联系管理员排查

更完整的状态码说明见状态码说明。

示例：OpenAI 兼容请求

curl "https://ai-pixel.online/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

客户端接入步骤见客户端接入。

创建 API Key