小白教程：皮皮工艺站简单教程（把闲置的token利用起来）

O、你有没有过这样的烦恼

手里的token太多，薅了很多羊毛用不完浪费了，想分享给佬友们却不知如何下手。难道还要买服务器、学部署、配环境？各种概念劝退了无数热心的萌新佬友们。

好在 @picpi 佬出了在线 picpi皮皮工艺站，可以方便的分享啦。但对于第一次接触sub2api的用户可能还是一脸懵逼，账号、分组、订阅、代理、密钥，这些都是什么呀？他们之间是什么关系？我第一步应该做什么？

那么，今天就用小白的视角，讲一讲这些基本概念和使用方法。

一、picpi是什么

picpi 是一个基于 sub2api 等组件搭建的共享 API 中转服务：你把自己的 Claude/ChatGPT 订阅账号（Plus 号）导入进来，它帮你转换成 OpenAI/Anthropic 兼容格式的 API，供各种客户端（思源笔记、Claude Code、Cherry Studio、Lobe 等）调用。

调用链路： 你的客户端 → picpi（sub2api）→ 你自己的 Claude/OpenAI 账号

二、核心概念（先弄懂这5个）

概念 |
作用 |

账号 |
就是你导入的 Plus 号（OAuth 或 json 配置），是你的算力来源 |

分组 |
账号的容器。一个分组 = 一个号池，请求会在组内账号间自动调度、故障切换 |

订阅 |
你对某个分组的使用权。picpi中自己建的分组会自动有订阅（即把用户和分组绑定） |

API 密钥 |
客户端调用时用的 sk-xxx，每个密钥绑定一个分组 |

代理 |
为账号提供访问上游平台的网络出口/IP（即从哪里访问账号） |

关系： 账号加入分组 → 用户获得该分组的使用权限（订阅）→ 创建绑定该分组的 API 密钥 → 客户端使用密钥调用

一个简单的比喻：

- 账号：干活的人

- 分组：人员所在的工作组

- 订阅：进入这个工作组下单的资格

- API 密钥：客户端使用的门禁卡，上面标明进入哪个工作组

- 代理：干活的人前往上游平台时使用的网络线路

另一个视角：

资源关系：账号 → 加入分组

权限关系：用户 → 持有分组（订阅）

调用关系：API 密钥 → 绑定分组

网络关系：账号 → 绑定代理 → 连接上游

三、完整请求链路

这样你可能还不太明白，那么就从你熟悉的 API 密钥开始，讲一下请求从客户端发出到结果返回的完整过程（注意以下是便于理解的简化流程，仅供参考）。```
① 客户端
│
│ 携带 API 密钥 sk-xxx、模型名和对话内容
▼
② API 接口／网关
│
│ 校验密钥是否存在、启用、过期
▼
③ 系统读取 API 密钥绑定的分组
│
│ 确定请求需要进入哪个账号池
▼
④ 校验用户对该分组的订阅
│
│ 检查订阅是否有效、是否过期、额度是否充足
▼
⑤ 分组调度器选择账号
│
│ 根据平台、模型、状态、额度和负载
│ 从组内挑选一个可用账号
▼
⑥ 被选中的上游账号
│
│ 读取该账号保存的 OAuth 凭据、JSON 认证配置或上游 API Key
▼
⑦ 账号绑定的网络代理（可选）
│
│ 决定通过哪个出口 IP 连接上游
│ 不绑定则走服务器默认网络
▼
⑧ 上游模型平台
│
│ OpenAI / Anthropic / Grok 等处理请求
▼
⑨ 上游返回模型结果
│
│ 流式数据或一次性 JSON
▼
⑩ 中转系统接收并转换
│
│ 转换为客户端兼容的 API 格式
│ 记录请求和 Token 用量；如订阅设置了配额，则扣减相应配额；同时更新上游账号的用量窗口和可调度状态
▼
⑪ API 网关把结果返回
▼
⑫ 客户端收到模型回复
```四、picpi配置流程

理论讲完了，下面开始实战环节。

其实一点都不难，核心三大步，创建分组 → 创建账号 → 创建密钥。

第 1 步：创建分组（我的分组）

- 左侧菜单 →「我的分组」→「创建分组」

- 填写：

- 名称：随意，如 claude_1

- 平台：选 Anthropic（Claude 号）或 OpenAI（ChatGPT 号）。创建后不可改

- 计费类型：选「订阅（配额）」。创建后不可改

- 其他（费率倍数、RPM、限额）保持默认即可

- 一般一个平台一个分组。Claude 和 OpenAI 账号不能混在一个分组里。如果你想把多个平台账号放到一个分组中，这里平台选Composite即可。

第 2 步：添加账号（我的账号）

- 左侧菜单 →「我的账号」→「添加账号」

- 选择平台（Anthropic / OpenAI）和认证方式：

- OAuth：跳转官方登录授权

- 导入 json：你的账号配置文件。注意：必须是 sub2api 格式，其他格式（cpa 等）需先转换，站长给的转换工具：https://cvt.okcode.cc.cd/。支持批量导入

- API Key：也可以通过api key的方式提供。

- 选择代理：可选。可以用公开代理（如"美国纯净家宽1/2/3"），也可以在「我的代理」里添加自己的机场节点（支持常见机场订阅，内置 sing-box）

- 公开代理人多共用 IP，账号有一定封号风险；重要账号建议用自己的代理

- 把账号勾选加入你创建的分组（编辑账号弹窗底部的"分组"处勾选）

- 添加后确认账号状态为「正常」、「调度已开启」

- 注意：使用第三方中转都有一定的风控风险，不建议把你重要的账号通过第三方代理。

第 3 步：创建 API 密钥（API 密钥页）

- 左侧菜单 →「API 密钥」→「创建密钥」

- 选择绑定的分组（如 claude_1）

- 得到 sk-xxxxxx，点复制保存好

注意：这里通过账号选择分组、密钥绑定分组实现了分组和账号、密钥和分组之间的关联。

第 4 步：在客户端配置

接入端点（任选一个，按网络情况）：

端点 |
说明 |

https://cn2.picpi.top |
阿里云香港，国内最快（不支持 WebSocket） |

https://cn.picpi.top |
腾讯云 CDN |

https://api.picpi.top |
Cloudflare 主站 |

https://us.picpi.top |
美国直连 |

https://api.280181.xyz |
Cloudflare 备用 |

每个端点旁有「测速」链接，可以先测哪个快。

客户端填写：

- API 地址（Base URL）：如 https://cn2.picpi.top（OpenAI 格式接口是 /v1/chat/completions，有的客户端要填到 /v1）

- API Key：你的 sk-xxx

- 模型名：先请求 /v1/models 查看可用列表，或用分组里账号实际支持的模型（如 claude-fable-5、claude-sonnet-4-8 等）

注意：密钥右侧有「使用密钥」按钮，可查看不同的客户端的使用教程。

五、其他功能

- 使用记录：排查请求错误、模型、Token 和消费；

- 分配订阅：把自己分组的使用权授权给其他 picpi 用户；

- 兑换码：批量发放订阅权益；

- 我的订阅：查看自己拥有的分组使用权；

- 我的代理：测试和管理上游网络出口。