Skip to content

About

把讯飞 AStudio(星辰 Studio)客户端的账号池变成 OpenAI 兼容 API —— 多账号负载、自动签到。Go 单二进制,零依赖。协议逆向,无需抓包或改客户端。

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

astudio2api

把讯飞 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 看账号健康、积分分段、签到与出口,按钮直接同步/签到

快速开始

Go 生产版(推荐)

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 —— 内置控制台,不用记命令。

Python 参考版

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)

HTTP 接口

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 控制台(静态页,本身不含数据也不鉴权)

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 通道。

账号池调度

  1. 零计费优先 —— 该账号目录里此模型标免费(x0.00)的排最前
  2. 快过期优先 —— 同档内积分最早到期的排前,避免过期作废
  3. 同级轮询 —— 完全同档的账号之间轮询分摊
  4. 会话黏绑 —— 同一会话键 30 分钟内固定同一账号
  5. 零余额退场 —— 余额为 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 之间的四条转换约束

网关对外只暴露 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 通道再打一次

免责声明

  • 本项目仅供个人账号自用与协议研究,系独立实现,与讯飞官方无关。
  • 请遵守讯飞的服务条款,不要用于批量注册、转售或任何违反条款的用途。
  • 本项目基于特定客户端版本与链路测试验证,上游协议变更即可能失效, 不同账号的权益与模型可用性亦存在差异;使用产生的账号风险由使用者自行承担。

License

MIT,见 LICENSE。

Community

感谢 LINUX DO 社区提供开放友好的技术讨论平台。

About

把讯飞 AStudio(星辰 Studio)客户端的账号池变成 OpenAI 兼容 API —— 多账号负载、自动签到。Go 单二进制,零依赖。协议逆向,无需抓包或改客户端。

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages