打开 GitHub 仓库 · 完整手册 · 给 AI 的 SOP 提示词
我把这段时间围绕 Muse 整理的 API 适配、配置和使用流程,做成了一个独立开源项目:Muse2API。
在我既有的个人工作流里,感受是:实测效果还行。 这是个人使用体验;这份开源版本在新账号、不同地区和新电脑上的安装与媒体链路,仍然需要逐项验收。
为什么整理成项目
从网页里完成一次创作,到让自己的程序持续使用,中间还有不少事情:怎样登录、配置放哪里、进程重启后如何恢复、视频断线后怎样查询,以及怎样让 AI 按同一套步骤操作。
所以这次一起整理了接口、会话保存、部署说明和调用工具。目标是让已有且获准使用的 Muse 账号接入个人工作流,减少每次从头摸索的成本。推理与生成仍由 Muse 上游完成,本机端口负责协议适配。
这一版包含什么
当前接口覆盖:
- 文字与图片理解:
POST /v1/chat/completions,提供同步回复与 SSE。 - 图片生成和编辑:
POST /v1/images/generations、POST /v1/images/edits,图片以 data URL 输入。 - 异步视频:
POST /v1/videos创建任务,使用返回的原 ID 查询状态、下载结果。
媒体调用会保存稳定的 request-id 和回执。超时、断线、5xx 或送达未知时,继续查询、等待或下载原资源,不自动再次创建。没有资源 ID 时保留回执定位,恢复查询不能用重新制作代替。
音频、PDF、已有视频文件输入、标准工具调用、独立 TTS,以及原生 seconds/size/seed 控制目前未开放。提示词里的时长、画幅和声线要求,要以实际文件检查;文字历史也不证明多个请求共享了原生会话。
从自己的本机开始
准备 Git、与仓库 go.mod 兼容的 Go、Python 3.10+,以及能正常使用 Muse 的 Chrome 或 Edge:
git clone https://github.com/7yedeng/muse2api.git
cd muse2api
python scripts/init_config.py
python scripts/run.py
配置脚本在本机生成私密密钥,已有文件不会被覆盖。接着在官网正常登录自己的账号,按仓库说明加载扩展、取得一次性码,由本人点击授权。Skill 不会替用户读取浏览器 Profile 或导出 Cookie。
业务端口默认是 18688,API 路径以 /v1 开头;管理端口默认是 18689,两者默认只监听本机。完整地址以自己的配置和手册为准。分别检查进程可访问、会话 ready、加密保存、重启恢复,再明确发起一次简短推理验证。本机安装步骤有完整说明。
本机、服务器和中转站怎样选
- 自己本机用: 本地运行,接入自己的客户端或 Skill,先把一个工作流走通。
- 自己的服务器: 通过 SSH 本地转发访问管理入口,在自己电脑的浏览器授权;会话加密保存到服务器,自有域名通过 HTTPS 提供业务 API。管理端口保持仅本机可达,持久化不等于永不过期。
- Sub2API / New API: 仓库提供接入说明,先验文字,再分别验图片与视频。当前没有已验证的通用 Muse 视频插件;媒体可按手册走直连或自己网站后端转接,不能只填 Base URL 就宣称全端点打通。
服务器方案见 部署 SOP,中转方案见 接入与验收矩阵。中转站用户 Key 与上游 Key 要分开,共享上游 Key 不自动提供多用户资源隔离。
让 AI 帮忙按 SOP 操作
仓库配了两份独立 Skill:
- muse2api-local:安装、启动、本人授权、持久化与重新登录。
- muse2api-client:使用自己的端点和 Key 调用,保留回执并查询、下载原任务。
也可以复制完整 AI 提示词,填写系统、目标和允许操作的范围。AI 应实际读取当前文档,区分已验证和待验证项目;密钥与验证码在自己的环境配置,不贴进聊天。
个人使用与官方权益
项目由社区独立维护,面向个人学习、协议研究与创作,没有 Meta 官方认证或背书。感谢 Meta 对 Muse 产品和开发者生态的投入,建议优先使用官方网页、App 与适用的官方开发者路径。
请尊重官方条款、账号权益、配额和服务成本。API 适配不会增加原有权益,也不为换号、账号池轮换规避用量或未经授权转售权益提供支持。MIT 许可适用于本项目有权许可的代码,不能代替上游服务授权;个人用途同样不自动豁免条款。使用说明单独写清了这些边界。
来源与验证记录
感谢 @0xraco 的开源分享。协议层使用并参考 CoolkHz/muse-protocol-go,分享来源和代码作者分别保留署名;第三方许可及未决信息见 NOTICE。
公开 CI 已通过 Go 19 项回归、14 项本机与发布检查、23 项客户端检查及 4 项扩展检查。这证明了相应工程行为,真实浏览器授权、上游媒体、Docker 与中转链路仍按验证记录分别验收。
欢迎 Star、反馈和 PR。普通贡献者通过分支提交,由维护者审核并通过检查后合并;源码与公开教程不包含维护者的真实账号、会话或私密环境。
