在自己的电脑上运行一个仅监听回环地址的 API,通过独立 Accio 登录使用本人可访问的模型和订阅额度。提供 Anthropic Messages 与 OpenAI Chat Completions 接口,可连接兼容客户端或 CC Switch、Magpie 等网关。
本项目是非官方社区桥接,与 Accio、Alibaba、Anthropic、OpenAI 无隶属关系。使用依赖已安装的官方 Accio 客户端及其原生签名模块;官方程序和原生模块不随仓库分发。请遵守所用服务的条款和账号权限。
| 能力 | 说明 |
|---|---|
| 双协议 | /v1/messages、/v1/chat/completions,支持流式文本 |
| 客户端工具 | 转发函数定义、调用及结果;工具在调用端执行 |
| 图片输入 | PNG/JPEG/WebP;支持用户图片与工具结果中的图片 |
| 生图与改图 | Accio 原生图片接口;可选 MCP 支持 Accio / Codex 两个后端 |
| 实时模型目录 | 从当前账号获取可见且未锁定的模型,按真实别名选择 |
| 空间与额度 | 校验独立登录与官方所选空间;区分个人和团队订阅 |
| 本地凭据 | macOS Keychain / Windows DPAPI CurrentUser |
| 认证恢复 | 目录、额度及身份元数据遇认证失效时刷新并重试一次 |
| 并发 | 默认最多 50 个生成请求;原生签名最多 2 个子进程,其他排队 |
| 轻量运行 | 无 npm 运行依赖;Node.js 24+ |
flowchart LR
A[兼容客户端] --> B[可选 CC Switch / Magpie]
A --> C[Accio Local API]
B --> C
C --> D[官方 Accio 签名模块]
C --> E[Accio 模型网关]
| 平台 | 要求与验证边界 |
|---|---|
| Windows | x64、PowerShell 5.1+、Node.js 24+;原生图片接入实测 Accio 0.36.2 |
| macOS | Node.js 24+、系统 Python 3;历史验证为 Apple Silicon、Accio 0.34.5 |
| 账号 | 自行安装官方 Accio,使用自己的账号并选择有效个人或团队空间 |
Intel Mac、Windows ARM、Linux 未验证。官方客户端升级可能改变非公开接口。
git clone https://github.com/alan113523/accio-local-api.git
cd accio-local-api
npm test.\install-windows.ps1 -AccioExecutable 'C:\path\to\Accio.exe'
$install = Join-Path $env:LOCALAPPDATA 'Accio Local API'
& (Join-Path $install 'login-windows.ps1')替换官方程序路径,在浏览器亲自完成登录。默认安装到当前用户 LocalAppData,创建登录自启入口。完整 Windows 操作说明。
node install-mac.mjs
node "$HOME/Library/Application Support/Accio Local API/src/cli.mjs" login打开命令返回的官方登录地址。安装器注册当前用户 LaunchAgent com.local.accio-api。
安装完成后,用安装目录中的 CLI 执行 status、models、quota;key 命令显示本人本机 API Key。Windows 示例见上方文档;macOS 示例:
node "$HOME/Library/Application Support/Accio Local API/src/cli.mjs" status
node "$HOME/Library/Application Support/Accio Local API/src/cli.mjs" models
node "$HOME/Library/Application Support/Accio Local API/src/cli.mjs" quota
node "$HOME/Library/Application Support/Accio Local API/src/cli.mjs" key| 配置项 | 值 |
|---|---|
| Anthropic Messages base URL | http://127.0.0.1:18437 |
| OpenAI Chat Completions base URL | http://127.0.0.1:18437/v1 |
| API Key | CLI key 返回的本人本机 Key |
| 模型 | CLI models 或 /v1/models 返回的完整 id |
在客户端新建供应商,填写对应协议、地址和 Key。CC Switch 可按其文档选择路由模式;Magpie 可配置兼容上游。本项目不修改客户端配置。模型目录可见不代表所有模型或功能均做过调用测试。
CC Switch 的每分钟订阅积分查询:配置说明、查询脚本。客户端按价格表估算的金额与 Accio 实际订阅余额是不同指标。
在终端自行设置 ACCIO_LOCAL_API_KEY 和 ACCIO_MODEL,模型取自实时目录:
curl http://127.0.0.1:18437/v1/messages \
-H "x-api-key: $ACCIO_LOCAL_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d "{\"model\":\"$ACCIO_MODEL\",\"max_tokens\":128,\"messages\":[{\"role\":\"user\",\"content\":\"Hello\"}]}"| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /health |
无需 Key 的健康检查 |
| GET | /status |
登录状态、本地生成并发上限与活跃请求数 |
| GET | /v1/models |
实时模型目录 |
| GET | /quota |
当前所选空间的订阅额度 |
| POST | /v1/messages |
Anthropic Messages |
| POST | /v1/chat/completions |
OpenAI Chat Completions |
| POST | /v1/images/generations |
Accio 原生生图,JSON 请求 |
| POST | /v1/images/edits |
Accio 原生改图,JSON + base64 参考图 |
除健康检查和登录回调外均需 Key;支持 Authorization: Bearer 或 x-api-key。仅监听 127.0.0.1,不开放浏览器跨域访问。
- 支持文本、流式、客户端函数工具与工具结果;服务本身不执行工具或读取业务文件。
- 支持 OpenAI
reasoning_effort及 Anthropic adaptive thinking /output_config.effort映射;不输出思考正文或签名,不支持budget_tokens。 - 支持 Anthropic
image与 OpenAIimage_url,以及工具结果中的图片;支持 PNG/JPEG/WebP,仍受 8 MiB 请求体限制。 - 兼容 Claude Code adaptive thinking 的
omitted/updates展示提示,以及clear_thinking_20251015、keep=all的无操作上下文提示;不支持其他上下文编辑。 - 原生聊天接口不交付结构化图片响应;遇到时明确报
unsupported_image_response,避免静默丢图。生成与编辑图片通过下述独立工具交付。 - 不支持 Responses、精确 count_tokens、文档、服务端工具或强制工具选择;不支持的请求会明确报错。
- 默认最多 50 个生成请求,聊天请求最多 120 秒,图片请求最多 360 秒。生成请求不自动重试;仅认证元数据有一次刷新重试。50 并发是本地限额,不能据此承诺上游吞吐。
- 不添加身份、技能、记忆或规划提示词;上游云端是否添加隐藏内容无法独立证明。聊天请求
auto_model=false,不静默切换模型或账号;图片响应另行返回上游实际模型及回退标记。 - 缺失 usage 时不编造估算;Messages 必填用量为 0 并标记
accio_usage_unavailable。 - Cowork、长上下文及完整桌面工具能力未全面验证。macOS 的新版跨平台改动尚未在实机重新验收。
integrations/codex-image 提供独立 stdio MCP 服务:
image_generate:提交生图任务,立即返回job_id。image_edit:使用本机参考图编辑或生成图片。image_status:查询任务,完成后取得真实文件路径、尺寸和可选内联图片。
图片工具可选两个后端:
| 后端 | 所需环境 | 使用额度 |
|---|---|---|
accio |
本项目 0.4.0+ 正在运行,使用本人 Accio 登录 | Accio 图片额度;无需 Codex CLI 或 Codex 账号 |
codex(兼容默认值) |
已安装并登录的 Codex CLI | 本人的 Codex 额度;官方说明 |
只有 Accio 的用户,将模块中的 bridge.accio.example.json 复制为 bridge.json,再按模块文档登记 MCP。自定义安装目录需设置 accioApiKeyFile,指向本人安装的 state/api.key。工具也接受 backend: "accio" 或 backend: "codex" 单次选择。失败不会自动改用另一个后端,也不会自动重发可能扣费的图片请求。
Accio 后端默认使用原生模型代码 gpt-image-2;这是 Accio 网关中的图片模型选择,使用 Accio 额度。真实生图、参考图编辑和 MCP 文件交付已验证;其他原生模型代码的实际可用性受当前账号与上游服务影响。原生图片接口与限制。安装主 API 不会自动登记或启动图片 MCP。
该模块复用 qiaomu-codex-imagegen 的 MIT 核心实现,并保留许可证和来源说明。无 npm 运行依赖;Windows 路径、异步任务及文件交付已验证,macOS 尚未实机验收。
出现 login_required / accio_auth_expired? 先运行登录命令,用本人账号重新授权。仅 authenticated: true 不能证明云端登录仍有效,应同时检查 models 和 quota。
出现 space_account_mismatch / official_space_unavailable? 在官方客户端选择有效空间,并确保桥接独立登录属于同一账号;不会自动回退到个人池。
Windows 签名失败? 检查安装配置中的官方 Accio 路径和客户端版本。直接开发运行时需设置 ACCIO_DESKTOP_EXE、ACCIO_APP_VERSION、ACCIO_API_STATE_DIR;安装后优先使用启动脚本。
升级如何处理? macOS 安装器备份并覆盖自有白名单文件;Windows 拒绝覆盖已有目录,安装新目录并重新登录,先保留旧状态。没有自动更新器。
npm test离线测试使用合成账号、凭据与模拟上游,不连接真实模型。Windows DPAPI 测试只使用临时合成数据。本次发布验证与历史 macOS 验证摘要分开记录。
可选实测会使用本人的订阅额度,需在已配置好本人安装环境的终端手动运行:node test/live-smoke.mjs、node test/live-tool-smoke.mjs。它们不是默认测试的一部分。
仓库只含通用代码、测试和脱敏说明,不包含 API Key、OAuth 凭据、Cookie、账号/团队标识、真实余额、日志、个人配置或官方客户端文件。请勿将运行时 state/、windows-install.json 或登录链接上传到 Issue。分发范围。
FILES.json 与 SHA256SUMS.txt 记录本次源码快照;macOS/Linux 可运行 shasum -a 256 -c SHA256SUMS.txt。清单不包含 Git 元数据及运行数据。
欢迎提交不含真实账号数据的复现步骤与补丁。说明系统、Node.js 和 Accio 版本,使用合成输入,并先运行离线测试。
README 信息结构参考 CC Switch 与 CLIProxyAPI 的项目介绍、快速开始、配置与文档导航;未复制其实现代码。协议说明。