把讯飞 AStudio(星辰 Studio)客户端的账号池变成 OpenAI 兼容 API —— 多账号负载、自动签到领积分。
协议逆向自 AStudio 客户端安装包(Electron + NSIS),无需抓包、无需修改客户端。 版本变更见 CHANGELOG.md。
设计参考:maiphucgiang/codebuddy2api(MIT)—— 多账号池、积分台账与自动签到的架构思路来自该项目。本项目面向讯飞 AStudio, 协议、模型与账号体系均为独立实现,与该项目无代码依赖关系。
| 项目 | 许可 | 参考了什么 |
|---|---|---|
| maiphucgiang/codebuddy2api | MIT | 多账号池调度、积分台账、自动签到的整体设计 |
- OpenAI 兼容:
/v1/chat/completions(流式 + 非流式)、/v1/responses、/v1/models - 上游原生 OpenAI 协议,不做格式转换,透传即可
- 两种实现,台账互通(同一个
state.json可互相接管)go/—— 生产版,单二进制、纯标准库、零依赖astudio/—— Python 参考版,留作协议对照与快速探针
- 多账号池:零计费优先 → 快过期优先 → 同级轮询,会话级黏绑
- 自动签到:按
(账号, 日期)幂等,领取前后用累计发放量自测战果 - 模型名归一:
GLM-5.2、glm 5.2、xopglm52都能命中同一个模型 - 失效隔离:401 冷却账号、403 只冷却该模型(不牵连账号上其它模型)
- 两套鉴权各走各的:
api_key只打 MaaS chat、jwt只打 model-gateway responses,互不通用;JWT 由服务端换票得来,不装客户端也能跑 Responses 通道 - 账号级出口代理:一个进程里多个账号各走各的 IP(
http/https/socks5) - 内置 Web 控制台:浏览器开
/ui看账号健康、积分分段、签到与出口,按钮直接同步/签到
cd go
go build -o astudio2api . # 纯标准库,无第三方依赖
./astudio2api accounts login --account <手机号> # 加账号(密码免回显,不落盘)
./astudio2api doctor # 五项自检:账号/目录/积分/签到/推理
./astudio2api serve # 起网关 → 127.0.0.1:8788网关起来后浏览器打开 http://127.0.0.1:8788/ui —— 内置控制台,不用记命令。
pip install -r requirements.txt
python astudio2api.py accounts import # 导入客户端当前登录的账号
python astudio2api.py doctor
python astudio2api.py serve然后任何 OpenAI 客户端改 base_url 即可:
curl http://127.0.0.1:8788/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.2","messages":[{"role":"user","content":"你好"}]}'三种方式,任选:
| 方式 | 命令 | 说明 |
|---|---|---|
| 账号密码(首选) | astudio2api accounts login --account <手机号> |
服务端直登,不需要浏览器、不需要装客户端 |
| 地址栏 URL | python tools/add_account_from_url.py '<URL>' |
网页登录后把整串 URL 粘进来,自动抠出凭证并验活 |
| 客户端会话 | astudio2api accounts import |
读 AStudio 客户端当前登录态(需本机装了客户端) |
密码登录走讯飞统一认证的 SSOService/login/check-account(GET,写成 POST 会吃 405)。
账号命中极验滑块时服务端会先返回 if-captcha=true,此时只能改用后两种方式。
新增账号按 accountId 去重:同一账号重复导入会更新原文件,不会在池里出现两份凭据
(两份凭据会让该账号的调度权重翻倍)。
新号必须先初始化 Studio 用户。密码登录成功不代表能取到模型:从未初始化过的 账号,
bot/models/configs会返回空清单,账号池据此判定「没有模型」直接拒收, 表象像是「必须先用客户端登录一次」。真因是客户端启动时调的那步POST tenant-app/v2/init-app(创建 Studio 用户并下发模型)。所以accounts login会在SyncModels之前补调一次。该接口幂等,老号再调只返回studioUserCreated=false,无副作用(它同时就是签到口)。
对外暴露的只有各账号都通用的模型,避免请求落到没有订购权限的账号上:
| 对外名 | 上游代号 | 倍率 |
|---|---|---|
spark-x2.6 |
spark-x2.6 |
— |
spark-x2.6-lite |
spark-x2.6-4b |
— |
glm-5.2 |
xopglm52 |
×2.0 |
deepseek-v4-pro |
xopdeepseekv4pro0813 |
×2.0 |
deepseek-v4.1-flash |
xdeepseek-flash-in |
×1.0 |
deepseek-v4-flash |
xopdsv4flash0731in |
×1.0 |
其余模型(GLM-5.1、Kimi-K2.6、Qwen3.6-35B-A3B、MiniMax-M2.5、
Spark-X2-Agent、Spark-X2-Flash、Auto)不对外列出,但仍可直接按名调用。
Spark-X2.5 客户端已提示下架,故从对外清单移除,但保留在解析表里 —— 老调用方
继续用 spark-x2.5 这个名字不会失效。下架 ≠ 解析失效,暴露与解析是两件事。
图片输入按模型能力走:chat 的多模态 content 按 parts 透传
(text → input_text,image_url → input_image),不再被转换层悄悄丢掉。
支持视觉的模型(如 deepseek-v4.1-flash)正常识别;不支持的由上游回
empty_image_file。转换层不替模型决定「这张图能不能看」——丢掉图片让模型对着
纯文字瞎答,比报错更糟。
为什么这样切分:这些模型的订购权限按账号而异。若一律对外列出, 请求被调度到没有权限的账号上就会吃
403 code 11200,还白烧掉该模型的冷却额度。 所以暴露要窄,解析要全 —— 两个关注点是分开实现的 (unionModels()管暴露,aliasModels()管解析)。
| 变量 | 默认 | 说明 |
|---|---|---|
ASTUDIO_API_KEY |
空(不校验) | 网关访问密钥;对外监听前务必设置 |
ASTUDIO_PORT |
8788 |
监听端口(serve --port 可覆盖) |
ASTUDIO_ACCOUNTS_DIR |
<repo>/accounts |
账号目录 |
ASTUDIO_STATE_PATH |
<repo>/state.json |
台账文件 |
ASTUDIO_SESSION_PATH |
自动探测 | 客户端活会话文件 |
二进制放在
bin/子目录时,默认账号目录会跟着变成bin/accounts, 此时要显式给ASTUDIO_ACCOUNTS_DIR。
监听地址没有环境变量,只有 serve --host <addr>(默认 127.0.0.1)。
对外暴露前必须先设 ASTUDIO_API_KEY,否则网关无鉴权,启动日志会警告。
| 命令 | 作用 |
|---|---|
accounts list |
看池里有哪些账号 |
accounts login --account A [--password P] |
账号密码登录并入库 |
accounts import [--name N] |
导入客户端当前登录的账号 |
accounts remove --name N |
移除账号 |
models |
各账号可用的模型与倍率 |
credits |
各账号积分、分段与到期时间 |
checkin [--dry] [--force] |
手动签到领积分 |
sync |
刷新全部账号的模型目录与积分 |
doctor |
五项自检(账号 / 目录 / 积分 / 签到 / 真实推理) |
serve [--host H] [--port N] |
启动网关(默认 127.0.0.1:8788) |
OpenAI 兼容:/v1/models、/v1/chat/completions、/v1/responses
管理面:
| 接口 | 作用 |
|---|---|
GET /health |
存活 + 账号健康(无需鉴权) |
GET /admin/accounts |
账号列表:模型数、积分、签到状态、冷却 |
POST /admin/accounts/login |
账号密码登录入库 |
POST /admin/accounts/import |
导入账号(?name= / ?path=) |
DELETE /admin/accounts/{name} |
移除账号 |
GET /admin/credits |
全池积分汇总(含分段与到期) |
GET /admin/points?account=N |
单账号实时余额 |
GET /admin/models |
按账号看模型供给 |
POST /admin/checkin |
手动签到(?dry=true 只看不领,?force=true 忽略当日幂等) |
POST /admin/sync |
刷新目录与积分(逐账号报真实上游错误,查账号存活最快的一条路) |
POST /admin/reload |
重扫账号目录 |
POST /admin/credits/refresh |
强制刷新积分(走真实上游,不吃缓存) |
GET /ui、GET /admin/ui |
内置 Web 控制台(静态页,本身不含数据也不鉴权) |
/ui 和 /admin/ui 是同一个页面,单文件 embed,零前端依赖。
- 账号卡:健康状态、积分分段与到期、模型数、出口(userinfo 脱敏)、今日签到、最近错误
- 按钮:刷新 / 同步全部 / 立即签到 / 热重载
- 数据怎么走:页面本身只是一个静态 HTML,不含任何账号数据、也不需要鉴权;
数据全部由浏览器带
Bearer调/admin/*。key 只存在浏览器localStorage(a2a_key),不进页面、不进日志。这样既给了图形入口,又不扩大暴露面。 - 四个数据端点用
allSettled并发取,单点失败不会整页空白。 /health里带version字段,页面直接显示当前跑的版本。
页面顶部有一个 key 输入框(type=password):填 ASTUDIO_API_KEY 的值即可,
它只写到本机 localStorage,不会回传服务器。网关本身没设 key 时留空直接进。
换浏览器/清缓存后要重填 —— 这也是它不落服务端配置的代价。
一个进程里多个账号各自从不同 IP 出网,不必为每个号起一个容器。
在账号文件最外层写 proxy / proxy_url / proxy-url 中任意一个即可:
{
"accountId": "...",
"jwt": "...",
"proxy": "socks5://user:pass@127.0.0.1:11081"
}- 支持的 scheme:
http/https/socks5/socks5h(socks5h归一成socks5, Go 标准库在 socks5 下同样用对端解析 DNS) - 有
proxy的账号拿到独立 Transport(独立连接池 + 独立出口);其余账号共用 默认 client,仍认HTTP(S)_PROXY环境变量 - 未配置时行为与旧版完全一致,不需要迁移
- 重新登录不会冲掉账号的运营配置(
proxy/upstreamMode/responsesBaseURL等)
一个账号有两套凭证,各自只对一条通道有效:
| 凭证 | 来源 | 长相 | 能打哪 |
|---|---|---|---|
api_key |
GET bot/models/configs 下发 |
65 字符 | 只对 MaaS /chat/completions |
jwt |
POST auth/bearer-token 换来的 modelBearerToken |
155 字符 JWT | 只对 model-gateway /responses |
实测过的两种错法:
- 拿
api_key打 Responses →401 apikey not found - 拿
jwt打 MaaS chat →401 API_KEY_DISABLED
所以「某账号的 api_key 打 responses 401」不能推出「这个号没订购 responses」——
同一时刻它的 JWT 打 responses 可能是 200。旧实现只看 api_key,会把有权限的号
误判成没订购。
JWT 是服务端签发的,不是客户端本地签的(asar 里唯一的 HMAC 密钥是它给 2 段会话
令牌用的,自签 HS256 实测不匹配,这条路已排除)。签发接口只需 SSO cookie,无 body,
每次调用重签,exp 约 3 年。所以 login 流程在 SyncModels 之后顺手换票写进账号文件
(jwt 字段,也认 clientToken / client_token),jwtNeedsRefresh 按 exp 判,
剩余不足 24 小时才重取。
结论:只要有 SSO cookie,不装 AStudio 客户端也能跑 Responses 通道。
- 零计费优先 —— 该账号目录里此模型标免费(
x0.00)的排最前 - 快过期优先 —— 同档内积分最早到期的排前,避免过期作废
- 同级轮询 —— 完全同档的账号之间轮询分摊
- 会话黏绑 —— 同一会话键 30 分钟内固定同一账号
- 零余额退场 —— 余额为 0 的账号只接自己目录里标免费的模型
失败处理:401 冷却账号 10 分钟;403 只冷却该模型 30 分钟;429 冷却该模型 60 秒;5xx 冷却 30 秒。单次请求最多换 3 个账号重试。
为什么 403 要按模型级而非账号级冷却:403 是「该账号未订购此模型」, 账号上其它模型仍然可用。若当账号级失效把账号整体下线,一个未订购的模型 就会拖死该账号上所有可用模型。
- 网关启动 30 秒后首签,之后每小时兜底(按
(账号, 日期)幂等) - 真正发分的接口是
POST tenant-app/v2/init-app(客户端启动登录时调的就是它), 一次发两笔:常规每日登录积分(体验版 100 / 标准版 200 / 高级版 400)+ 活动期加成(例如国庆额外 5000 星火积分) - 计量用
totalAmount(累计发放,单调递增),不是totalBalance(会被调用消耗) - 「一天」按北京时间(上游时区)算,不跟随宿主时区 —— 跑在 UTC 容器里也不会 在北京时间 00:00–08:00 把签到算成前一天
- 手动触发:
POST /admin/checkin?dry=true/?force=true
易错点(重要):签到不是走
client-popups/pending→client-popups/complete。 那两个弹窗接口只打扫 UI 状态、一分不发(连调两次都返回成功而余额不动), 客户端自己也从不调用它们。真正发分的是tenant-app/v2/init-app。 若按弹窗接口记账,会把当天写成ok=true, claimed=0从而当天不再重试, 表现为新账号静默漏签、且台账看起来是成功的。
| 项 | 值 |
|---|---|
| 账号站 | https://agent.xfyun.cn/xingchen-studio/ |
| 模型网关 | https://maas-api.cn-huabei-1.xf-yun.com/v1(配置下发的 /v2 也通) |
| 必需请求头 | clientType: 21(Win) / 22(mac)、studioVersion(与所装客户端版本一致,当前 3.6.4) |
| 会话文件 | <state>/userdata/astron-session.json |
| api_key 刷新 | GET bot/models/configs(cookie 认证)→ 各模型的 api_key(打 chat) |
| Responses 通道 | https://astronstudio-api-volces-prod.xf-yun.com/model-gateway/v1(账号可写 responsesBaseURL 覆盖) |
| JWT 换票 | POST auth/bearer-token(cookie 认证,无 body)→ data.modelBearerToken,exp 约 3 年 |
| 模型目录缓存 | <state>/userdata/provider-model-catalog-v1.json |
| 签到(真正发分) | POST tenant-app/v2/init-app |
| 弹窗(空操作) | client-popups/pending、client-download-reward/claim、client-popups/complete |
| 积分 | points/balance、points/summary、points/details?pageNum=&pageSize= |
| 套餐 | membership/me |
| 账号密码登录 | GET https://sso.xfyun.cn/SSOService/login/check-account?accountName=&accountPwd=&isAct=false |
状态目录不在用户 home:AStudio 装在 D:\AStudio 时,状态在 D:\AStudio Data\
(与安装目录同级,不是 %APPDATA%)。不确定时读进程命令行里的 --user-data-dir=。
两份模型清单内容不同,别拿错:
| 来源 | 内容 | 用途 |
|---|---|---|
bot/models/configs |
较全(含只有部分账号有权限的) | 取 api_key |
provider-model-catalog-v1.json |
客户端选择器实际展示的那几个 | 判断「客户端能用哪些」 |
网关对外只暴露 chat 协议,账号走 Responses 通道时由网关做双向转换。转换层有四条硬约束,
不满足时上游返回 invalid_prompt:
| 约束 | 表现 | 网关处理 |
|---|---|---|
call_id 归属 |
上游只接受本账号本模型签发过的 id,外来 id 一律 400 | 维护 id 台账,按客户端 id 粘性换发 |
| 成对相邻 | function_call 必须紧跟自身的 function_call_output |
按调用逐对交错输出 |
| 单请求上限 | input 内 function_call 最多 9 项 |
超出部分折叠为文本摘要,保留最近 9 个 |
tool_choice |
仅接受 auto / none / 缺省 |
其它取值丢弃,避免整轮失败 |
流式场景下上游把校验错误放在响应开头的 response.failed 事件里,HTTP 状态仍为 200。
网关在写响应头之前判定一次,转为 HTTP 400 并带上游原文 —— 否则代理层会把这次请求记成
「200 + 0 token」的空回成功,既不记录错误也不切换渠道。
见 docs/DEPLOY.md(从零到接进 new-api 的完整步骤)。 维护 / 改动影响面 / 排障见 docs/MAINTENANCE.md —— 改任何东西之前值得先扫一眼它的「改动影响面」表,这个项目的坑基本都在「只改了一处」。
deploy/ 下的脚本都从环境变量取值,默认值只是按推荐部署布局给的推测,
路径不同时用环境变量覆盖即可:
export ASTUDIO_SSH_HOST=<你的服务器>
export ASTUDIO_HOST_URL=http://<docker 网关 IP>:8788
export NEWAPI_DB=/opt/new-api/data/new-api.db
bash deploy/register_channel.sh # 注册/更新 new-api 渠道(幂等)
bash deploy/verify_channel.sh # new-api 侧权威验证
bash deploy/verify_models.sh # 逐个模型走容器路径验证
bash deploy/verify_relay.sh # 逐个模型走 new-api 真实中继验证cd go && go test ./... # Go:调度 / 签到台账 / 模型名解析 / 对外清单口径
python -m pytest tests/ -q # Python:调度 / 签到 / 加号去重 / 对外清单口径
python astudio2api.py doctor # 端到端五链路自检(需真实账号)- 这是逆向实现,不是官方接口,上游改协议即失效;
doctor用于快速定位坏在哪一环 - 积分按倍率消耗且有到期时间(
credits可查activityNextExpireTime),过期即作废 Spark-X2-Flash(spark-x)走讯飞自家端点,响应多包一层status/sid, 且在部分账号下即使关闭思考仍返回空响应,故未列入对外清单- 账号命中极验滑块时密码登录不可用,需改用 URL 导入或客户端会话导入
- Responses 通道与 chat 是两套鉴权、两套地址,凭证不能互换;混用只会得到 401
upstreamMode: "responses"的账号(Astron Coding Plan 类)走 model-gateway,spark系模型不在该网关的模型表里,会 404 —— 这类请求会自动退回该模型自己的 chat 通道再打一次
- 本项目仅供个人账号自用与协议研究,系独立实现,与讯飞官方无关。
- 请遵守讯飞的服务条款,不要用于批量注册、转售或任何违反条款的用途。
- 本项目基于特定客户端版本与链路测试验证,上游协议变更即可能失效, 不同账号的权益与模型可用性亦存在差异;使用产生的账号风险由使用者自行承担。
MIT,见 LICENSE。
感谢 LINUX DO 社区提供开放友好的技术讨论平台。