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

术语表

文档和控制台里出现的术语都收在这里,按主题分组。第一次读文档遇到不认识的词,直接来这页查。

接入相关

术语含义
API Key用户调用网关端点的凭证,来自控制台「API 密钥」。关联一个分组,受状态、额度、过期时间、IP 限制和分组策略影响
Base URL客户端请求 Pixel API 的入口地址,即站点域名 https://ai-pixel.online。API Key 是「谁在调用」,Base URL 是「调用发到哪里」
接口后缀Base URL 之后的路径,要和官方格式对齐,例如 /v1/chat/completions/v1/responses
CC-Switch本地客户端配置切换工具,用于把 Codex、Claude Code 等客户端指向 Pixel API
模型映射把客户端请求的模型名映射到实际调用的模型。客户端展示的模型名以映射和站点请求记录为准

分组与调度

术语含义
分组决定一次请求可以使用哪些上游能力,以及如何计费、限速和调度
共享分组 / 共享号池公共账号按调度策略轮询调用的分组,日常调用的默认选择
兜底分组主共享分组临时不可用时的回落分组,稳定性更强,成本可能更高
私有分组只允许账号本人调用自己托管账号的分组,对其他用户不可见
账号模式分组用户在账号广场选择具体账号后,API Key 固定调度该账号的分组
多分组路由在 API Key 中配置多个分组,请求按优先级自动回落
优先级调度排序依据,数字越小优先级越高
并发同时处理的请求数上限。分为账号并发和单用户并发
RPM / TPM每分钟请求数 / 每分钟 Token 数限制

账号共享

术语含义
上游账号承载真实模型调用能力的账号,可以是 OAuth 账号、API Key 账号或特定平台凭证
私有模式账号只给自己使用,不进入共享号池
公共模式账号通过校验后进入共享号池,供其他用户调用并产生收益
账号模式用户在账号广场选择具体共享账号,请求固定走该账号
账号广场账号模式的前台市场,按平台、模型、席位、倍率等条件选择共享账号
席位 / 可使用人数一个上架账号最多允许多少用户同时占用
空闲退出用户连续空闲达到设定时间后,系统自动结束使用或解除绑定
保护百分比限制账号可被共享使用的 5 小时 / 7 天窗口额度比例,避免公共使用把账号额度打满
共享校验公共模式上架前的系统校验。状态包括公共已通过、公共待校验、公共已暂停
5h / 7d 窗口上游账号 5 小时和 7 天滚动窗口的剩余额度
预约队列账号满员时用户排队等待,一个账号模式 Key 最多预约 5 个账号,按顺序接续
结束原因用户结束使用的原因:manual(主动)/ idle_timeout(空闲超时)/ prepay_insufficient(余额不足)/ account_unavailable(账号不可用)

计费与收益

术语含义
倍率请求费用的乘数:用户请求费用 = 模型原始费用 × 倍率。分为分组倍率和账号倍率
小时费账号模式下用户激活占位期间按分钟预扣的费用
免小时费低消核销窗口内请求消费达到门槛后退回小时费的机制,0 表示关闭
最低余额准入用户加入账号广场账号前必须满足的余额门槛
模型白名单一个上架账号允许用户调用的模型列表
收益分成共享消费按比例结算。公共号池示例 85% 用户 / 10% 平台 / 5% 邀请者;账号广场(账号模式)为 号主 90% / 平台 10%,两套不同,以站点为准
余额流水「使用记录」里的资金明细,包含共享账号收益、账号模式收益、小时费预扣与退回等类型
订阅给用户分配周期性额度的计费方式
提现把余额中的收益按站点规则转出。最低 1.00,首次额外扣 0.10

钱包·商城·福利

术语含义
余额账户里的钱,用于请求计费、购物、账号广场小时费等
积分站内另一种可消费点数,可用于商城积分支付、兑换/活动奖励
并发数你能同时发起的请求数上限,可通过兑换码等提升
负载额度一种额度型资产,由商城「负载额度」商品或活动奖品发放
发卡商城 / 卡密自助购买数字商品的商店;卡密是交付的一段码或文件
兑换码单独输入即可到账余额/积分/并发/订阅的码,区分大小写、一码一次
优惠码充值或下单时抵扣或赠送的码,不独立到账
抽卡商城里随机返还余额/积分的商品,或福利活动里的免费抽奖机会
福利活动 / 消费抽奖消费达标获得抽奖机会,参与抽奖赢奖品
达标API 实际消耗或请求次数达到活动门槛,获得抽奖机会
邀请返利 / 邀请码邀请新用户,对方有效消费后按比例实时返利到余额
每周配额邀请码每周可用的次数上限
订单状态待支付 / 已支付 / 充值中 / 已完成 / 已过期 / 已取消 / 失败 / 退款等
发票为订单开具的发票(功能开关,可能隐藏)

下一步

本页目录