d10009d639
Open-source Grok free registration CLI, xai_enroller auth pipeline, local auth service, tests and docs.
101 lines
3.1 KiB
Markdown
101 lines
3.1 KiB
Markdown
# Grok Session → CPA / sub2api
|
||
|
||
纯前端单页工具：把 grok-free-register 产出的凭证，转成 CPA、sub2api 导入包、batch 建号、或 sso-to-oauth 请求体。
|
||
|
||
对照思路：GPT session → CPA / sub2api 纯前端转换器（同类工具，无外部依赖）。
|
||
|
||
## 本地使用
|
||
|
||
直接打开：
|
||
|
||
```text
|
||
tools/GrokSession2CPAAndSub2API/index.html
|
||
```
|
||
|
||
所有解析和转换都在浏览器本地完成，不上传 token。
|
||
|
||
## 支持输入
|
||
|
||
| 来源 | 说明 |
|
||
|------|------|
|
||
| `authenticated/xai-*.json` | 注册成功 OAuth（base_url 常是 api.x.ai） |
|
||
| `cpa_ready/xai-*.json` | watchdog 终态（带 headers/email） |
|
||
| `sub2api-data` / accounts 数组 | 已转换过的包，可再导成其它格式 |
|
||
| `auth-sessions.jsonl` | `email` + `cookies.sso` |
|
||
| `accounts.txt` | `email:password:sso` |
|
||
| `grok.txt` | 每行一个 SSO JWT |
|
||
|
||
可粘贴 JSON / 数组 / jsonl，或拖入多个文件。
|
||
|
||
## 输出格式
|
||
|
||
### CPA
|
||
|
||
对齐注册机 cpa_ready：
|
||
|
||
- `type: "xai"`
|
||
- `access_token` / `refresh_token` / `id_token`
|
||
- `base_url` **强制** `https://cli-chat-proxy.grok.com/v1`（忽略 authenticated 里的 `api.x.ai`）
|
||
- `headers`：保留源 headers，否则写 grok-cli 默认头
|
||
- `email` / `sub` / `expired` / `expires_in`
|
||
|
||
单条输出对象，多条输出数组。
|
||
|
||
### sub2api 导入
|
||
|
||
`type: "sub2api-data"` 包，可走 sub2api 数据导入：
|
||
|
||
```json
|
||
{
|
||
"type": "sub2api-data",
|
||
"version": 1,
|
||
"exported_at": "...",
|
||
"proxies": [],
|
||
"accounts": [ ... ]
|
||
}
|
||
```
|
||
|
||
账号字段：
|
||
|
||
- `platform: "grok"`, `type: "oauth"`
|
||
- `credentials.access_token` / `refresh_token` / `id_token` / `expires_at` / `email` / `sub` / `base_url`
|
||
- **有 `refresh_token`**：不写账号顶层 `expires_at` / `auto_pause_on_expired`（避免 access 6h 到期被 pause）
|
||
- **无 `refresh_token`**：写 access JWT exp + `auto_pause_on_expired: true`
|
||
|
||
### batch 建号
|
||
|
||
`POST /api/v1/admin/accounts/batch` 体：
|
||
|
||
```json
|
||
{ "accounts": [ /* 同上 sub2api 账号对象 */ ] }
|
||
```
|
||
|
||
### sso-to-oauth
|
||
|
||
`POST /api/v1/admin/grok/sso-to-oauth` 体：
|
||
|
||
```json
|
||
{
|
||
"sso_tokens": ["eyJ...", "..."],
|
||
"_meta": [ /* 仅本地对照，API 可忽略 */ ]
|
||
}
|
||
```
|
||
|
||
纯 SSO 输入（grok.txt / accounts.txt / auth-sessions）**只能**走这个格式；CPA / sub2api / batch 需要 OAuth。
|
||
|
||
## 关键规则（别踩坑）
|
||
|
||
1. free 号 API 走 `cli-chat-proxy.grok.com`，不是 `api.x.ai`。
|
||
2. free OAuth access ≈ 6h（`expires_in=21600`）。有 refresh 时让 sub2api 自己刷；别把账号级 `expires_at` 钉成 access exp。
|
||
3. 当前线上常见：refresh 被整批 revoke，access 在 exp 前仍可用。这种号导入后到期无法续命，只能重铸。
|
||
4. 注册机 `grok.txt` / `accounts.txt` / `auth-sessions.jsonl` 只有 SSO，没有 OAuth；要进 sub2api 要么走 sso-to-oauth，要么先走 xai_enroller 出 `authenticated/` 再转。
|
||
|
||
## 与注册机衔接
|
||
|
||
```
|
||
register → grok.txt / accounts.txt / auth-sessions.jsonl (SSO)
|
||
→ xai_enroller → authenticated/xai-*.json (OAuth)
|
||
→ acpa_watchdog → cpa_ready/xai-*.json + acc.md
|
||
→ 本工具 → sub2api-data / batch / CPA / sso-to-oauth
|
||
```
|