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

核心概念

用户

用户是平台内的消费主体。用户可以创建 API Key、查看用量、购买订阅或充值余额,也可以在支持的功能中绑定或共享账号。

在使用指南里,用户分成两条教程路径:

角色主要目标
普通用户使用 Pixel API 的共享能力,创建 API Key,接入客户端,发送消息并得到回复。
号主用户把自己的账号添加到平台,自用或共享给别人,并通过共享消耗获得收益。

API Key

API Key 是用户调用网关端点的凭证。它会关联到一个分组,并受状态、额度、过期时间、IP 限制和分组策略影响。

你可以把 API Key 理解成“给客户端使用的密码”。客户端每次请求都要带上它,平台才能知道:

  • 是哪个用户发起的请求。
  • 应该走哪个分组。
  • 应该如何扣费和记录用量。
  • 是否触发额度、限速、过期或 IP 限制。

第一次使用时,只需要创建一个绑定共享号池分组的 Key。跑通后再考虑多分组路由、额度限制、速率限制和 IP 限制。

分组

分组决定一次请求可以使用哪些上游能力,以及如何计费、限速和调度。常见配置包括:

  • 平台类型:OpenAI、Anthropic、Gemini、Antigravity 等。
  • 模型价格和倍率。
  • RPM/TPM 限制。
  • 可用账号池。
  • 模型路由和账号模式策略。

Pixel API 常见分组类型:

类型说明
系统兜底号池用于保障最终可用性的底牌
共享号池公共账号按调度策略轮询调用
账号模式分组用户在账号广场选择具体账号后,API Key 固定调度该账号
私有分组个人账号只允许账号本人调用,对其他用户不可见

共享分组倍率由站点按账号成本、模型能力和稳定性配置。兜底分组倍率可能更高,适合作为多分组路由的后备。

Base URL

Base URL 是客户端请求 Pixel API 的入口地址,就是站点域名本身:

https://ai-pixel.online

API Key 是“谁在调用”,Base URL 是“调用发到哪里”。两者都要配置正确。

接口后缀要和官方格式对齐

接口路径跟在 Base URL 之后,例如 Chat Completions 是 /v1/chat/completions,Responses 是 /v1/responses。部分客户端的 API Base 字段要求填到 /v1,以「使用密钥」弹窗给出的配置为准。完整端点列表见 API 参考

上游账号

上游账号承载真实模型调用能力,可以是 OAuth 账号、API Key 账号或特定平台凭证。平台通过账号健康状态、额度、并发和调度策略决定是否使用某个账号。

个人用户可将自己的账号托管到平台:

  • 私有模式:账号只给自己使用,不进入共享号池。
  • 公共模式:账号通过校验后进入共享号池,供其他用户调用并产生收益。
  • 账号模式:用户在账号广场选择具体共享账号,请求固定走该账号。

公共模式收益按站点策略结算。当前文档中的公共共享号池示例比例为 85% 用户 / 10% 平台 / 5% 邀请者账号广场(账号模式)的分成是另一套,代码默认为 号主 90% / 平台 10%。两套比例不同,均以站点当前配置为准

账号广场

账号广场是账号模式的前台市场。用户可以按平台、模型、席位、倍率、小时费、最低余额、并发等条件选择共享账号。

账号广场常见参数:

参数含义
账号倍率请求费用倍率
小时费用户激活占位期间按分钟预扣的费用
免小时费低消请求消费达到门槛后退回小时费
最低余额用户加入前必须满足的余额门槛
席位账号允许多少用户同时占用
单用户并发单个用户在该账号上的并发上限
模型白名单这个账号允许调用的模型
空闲退出连续空闲多久后自动释放席位

账号广场完整参数、默认值和上限见参数说明,用户侧使用流程见使用账号广场

订阅与余额

订阅用于给用户分配周期性额度,余额用于按请求计费或购买商品。开启支付后,用户可自助充值或购买套餐(见充值与订阅)。

余额也承载共享账号收益。用户可以将收益留在站内继续消费,也可以按站点规则申请提现。完整的计费与提现规则见计费与提现

用量记录

每次网关请求会记录模型、Token、费用、用户、API Key、分组和上游账号等信息。控制台会基于这些记录展示统计。

接下来读什么

理解了这些概念后,按你的身份继续:

本页目录