核心概念与术语

先记住一条链路，Pixel API 的大部分概念都挂在上面：

你 →（API Key）→ 分组 →（号池里的上游账号）→ 模型

一次请求要走完这四步。哪一步没配好，报错信息就指向那一步。

API Key：证明是你在调用

API Key 是一串 sk- 开头的密钥，在控制台「API 密钥」页创建。客户端每次请求都带上它，平台才知道这次调用记在谁头上、从谁的余额里扣钱。

把它当密码看待。别人拿到就能花你的余额，所以不要发到群里、截图里或公开仓库里。

分组：决定请求走哪个号池、怎么计费

每个 API Key 必须绑定分组。分组管三件事：能用哪些模型、请求发给哪批账号、按什么倍率扣费。

• 共享分组：一批公共账号轮询调用，日常调用选这个。
• 兜底分组：主共享分组临时不可用时的回落，稳一些，倍率通常也高一些。
• 私有分组：只调用你自己托管的账号，别人看不到。
• 账号模式分组：你在账号广场加入某个房间后，Key 固定走那个房间。

一个 Key 也可以配多个分组（多分组路由），请求按优先级依次尝试，前一个不可用就自动回落。第一次跑通时不要开，先把变量降到最少。

Base URL：决定请求发到哪里

Base URL 就是站点域名：

https://ai-pixel.online

API Key 回答"谁在调用"，Base URL 回答"调用发到哪"。两个都填对请求才能到。

接口路径接在 Base URL 后面，和官方格式一致，例如 /v1/chat/completions、/v1/responses。部分客户端的 API Base 字段要求填到 /v1 为止——以「使用密钥」弹窗给出的配置为准，别凭记忆填。完整端点见 API 参考。

上游账号：真正干活的那个账号

号池里的每个账号都是一个真实的 OpenAI / Claude / Gemini / Antigravity / Grok / OpenCode 账号。平台按健康状态、剩余额度和并发决定这次请求交给谁。

如果你手里有这样的账号，可以托管到平台，有三种用法：

• 私有模式：只给自己用，不进共享号池，不产生收益。
• 公共模式：通过共享校验后进入共享号池，别人调用就产生收益。
• 账号模式：在账号广场开房间，用户主动挑你的房间来用。

公共号池和账号广场房间按站点当前生效的全局分成策略结算，参与方可能包括号主、符合条件的邀请者和平台。策略只影响之后的用量；已经发生的用量保留当时的策略快照。具体比例以站点配置和余额流水为准。

账号广场：号主开房间，用户挑房间

号主把同平台、同等级的多个账号放进一个房间，配好倍率、席位和限制发布出去；用户按平台、等级、模型、健康账号数、倍率、小时费等条件挑房间加入。

房间满席时可以排队，一个账号模式 Key 最多预约 5 个房间，后续请求按顺序尝试激活。

号主侧完整参数见参数速查，用户侧流程见使用账号广场。

余额、订阅和用量

余额是账户里的钱，用于请求计费、商城购物和账号广场小时费。订阅按周期发放额度。共享账号的收益也进余额，可以留着继续消费，也可以按站点规则提现。

每次请求都会记录模型、Token、费用、用的哪个 Key、走的哪个分组和哪个上游账号。对不上账时就查这里。计费规则细节见计费与提现。

术语速查

遇到不认识的词直接在这里找。

下一步：普通用户去开始前准备，号主去准备账号。