grok-free-register-oss/tools/GrokSession2CPAAndSub2API

Grok Session → CPA / sub2api

纯前端单页工具：把 grok-free-register 产出的凭证，转成 CPA、sub2api 导入包、batch 建号、或 sso-to-oauth 请求体。

对照思路：GPT session → CPA / sub2api 纯前端转换器（同类工具，无外部依赖）。

本地使用

直接打开：

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 数据导入：

{
  "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 体：

{ "accounts": [ /* 同上 sub2api 账号对象 */ ] }

sso-to-oauth

POST /api/v1/admin/grok/sso-to-oauth 体：

{
  "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