连接信息 供你的应用使用
把下面两个值复制到要连接的应用中。
Model:
muse-spark (chat / code), muse-image (图片), muse-video (video).
在“API 指南”标签页中查看完整示例,见 “API 指南”.
账号总数
0
就绪
0
出错
0
已关闭
0
已生成文件
0
添加账号 可以导入多个账号
把 muse.ai 的 Cookie 粘贴到这里。每行一个账号;可以按
名称 | Cookie 的格式加上名称。
账号列表 0
自动刷新会话(30 分钟)登录会话会定期自动刷新。点击“检查”可在 muse.ai 上验证账号。
| 名称 | ID | 状态 | 会话已过期 | 额度 | 活动 | Cookie | 最近使用 | 备注 | 操作 |
|---|---|---|---|---|---|---|---|---|---|
| 加载中… | |||||||||
最快的方式:浏览器扩展 推荐
用扩展把你浏览器里的 muse.ai 登录会话转到服务里。无需使用命令行.
1
1. 下载扩展
下载并解压到一个好找的文件夹.
⬇ 下载浏览器扩展
2
2. 把扩展加载到浏览器
Chrome、Edge 以及兼容 Chromium 的浏览器都可以用:
- 打开
chrome://extensions - 开 开发者模式
- 选择 加载已解压的扩展
- 选择第 1 步解压出的文件夹
3
3. 登录并导入账号
登录
https://muse.ai/,然后在该页面上打开扩展。服务地址和 API key 会自动填好;你只需点击“获取 Cookie 并添加账号”.
其他方式:手动输入 Cookie 高级
如果不用扩展,就在浏览器的开发者工具里取 Cookie.
选择 tab Network,复制这一行
cookie: trong Request Headers.
- 打开并登录
https://muse.ai/ - 点击 F12,选择标签页 Network
- 点击 F5 以重新加载页面
- 选择一个请求到 muse.ai
- Trong Headers → Request Headers,找到这一行
cookie: - 复制冒号后面的全部内容,从这里开始:
hatch_sess= - 把 Cookie 粘贴到下面的输入框
注意:复制 Request Headers 中的
cookie: 行,不要用 Response Headers 里的 set-cookie.
输入 Cookie 或使用脚本
把复制好的 Cookie 粘贴到这里导入。
或者用 Python 脚本在单独的浏览器窗口里登录。无需安装额外的库.
复制正在生成命令…
③ 在弹出的窗口里登录 muse.ai。脚本会自动发送 Cookie 并关闭窗口.
Cookie 期限 参考
期限仅供参考;不同账号可能不同.
| Cookie | httpOnly | 期限 | 角色 |
|---|---|---|---|
| hatch_sess | 有 | 约 30 天 | 主登录会话 |
| hatch_gw | 有 | 约 1 年 | Token gateway |
| hatch_vml | 有 | 约 2 天 | 短期令牌,决定会话期限 |
| hatch_native_auth_device | 有 | 约 30 天 | 设备码 |
会话期限通常取决于
hatch_vml(约 2 天),且不会因使用而自动延长.
当会话过期或账号报错时,请重新登录并导入新的 Cookie.
已运行的任务 0
视频任务在后台运行,状态自动更新。
| 任务 ID | 类型 | 描述 | 状态 | 时间 | 创建日期 | 结果 / 错误 | |
|---|---|---|---|---|---|---|---|
| 加载中… | |||||||
文件库 0
已生成的图片和视频。可以查看、下载,或在其他应用中使用链接。
加载中…
试生成图片 POST /v1/images/generations
向 muse.ai 发送真实生图请求;通常需要 10–30 秒。
试生成视频 POST /v1/videos
任务在后台运行,通常需要 60–120 秒。页面会自动更新进度。
连接指南
兼容 OpenAI 的 API。在你的应用里,只需改
API 地址:
base_url 和 api_key.
API 地址:
—
1. 可用模型
| 模型 ID | 功能 | Endpoint |
|---|---|---|
| muse-spark | 聊天 / 编程(支持流式) | POST /v1/chat/completions POST /v1/responses |
| muse-image | 生成图片 / 编辑图片 | POST /v1/images/generations |
| muse-video | 生成视频 / 图生视频 | POST /v1/videos → GET /v1/videos/{id} |
各 Muse 模型对应功能如下:Muse Spark(聊天 / 编程)、Muse Image(生图)、
Muse Video(生视频)。muse.ai 页面会自动选择模型,所以像
gpt-4o, claude-sonnet-4 或 dall-e-3 都会被自动映射.
2. 聊天 / 编程
复制# 非流式 curl -X POST "BASE/v1/chat/completions" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"muse-spark","messages":[{"role":"user","content":"用 Python 写一个快速排序算法"}]}' # 流式:在其后加 "stream":true 以接收标准 SSE
3. 生成图片(curl)
复制curl -X POST "BASE/v1/images/generations" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"一只柴犬戴着宇航员头盔","size":"1:1","response_format":"url"}' # 结果 {"created":1790148495,"data":[{ "revised_prompt":"一只柴犬戴着宇航员头盔", "url":"http://your-server:18610/v1/media/xxxx.webp", "kind":"image","bytes":23860}]} # url 是用于显示/下载的完整地址;/v1/media/* 无需鉴权。 # 要接收 base64,设置 "response_format":"b64_json".
4. 生成视频(curl,后台运行)
复制# ① 创建任务 curl -X POST "BASE/v1/videos" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"一只猫在草地上走","duration":5,"size":"16:9"}' # → {"id":"task_xxx","status":"queued"} # ② 查看结果 curl "BASE/v1/videos/task_xxx" -H "Authorization: Bearer $MUSE2API_KEY" # → {"status":"succeeded","result":{"url":"/v1/media/xxx.mp4"}}
5. Python(兼容 OpenAI SDK)
复制from openai import OpenAI import time client = OpenAI(base_url="BASE/v1", api_key="m2a_...") # 生成图片 r = client.images.generate(model="muse-image", prompt="一只柴犬戴着宇航员头盔") print(r.data[0].url) # 生成视频(任务在后台运行,使用专用 API) import requests t = requests.post("BASE/v1/videos", json={"prompt":"猫在走路","duration":5}, headers={"Authorization":"Bearer m2a_..."}).json() while True: s = requests.get(f"BASE/v1/videos/{t['id']}", headers={"Authorization":"Bearer m2a_..."}).json() if s["status"] in ("succeeded","failed"): break time.sleep(5) print(s)
6. 管理 API
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /admin/status | 服务、账号与任务总览 |
| GET | /admin/accounts | 账号列表 |
| POST | /admin/accounts | 添加一个或多个账号 |
| PATCH | /admin/accounts/{id} | 改名或启用 / 停用 |
| DELETE | /admin/accounts/{id} | 删除账号 |
| POST | /admin/accounts/{id}/test | 检查登录会话和额度 |
| POST | /admin/accounts/{id}/quota | 读取剩余额度 |
| POST | /admin/accounts/{id}/cookies | 更新 Cookie |
| GET | /admin/tasks | 任务历史 |
| GET | /admin/media | 已生成文件列表 |
| POST | /admin/media/delete | 一次删除多个文件 |
7. 鉴权
除
/healthz、/readyz 和 /v1/media/* 外,其他 API 都需要
Authorization: Bearer <API Key>。在 `.env` 文件里用 MUSE2API_KEY 配置 key.
8. 连接应用和 agent
支持 OpenAI 兼容端点的应用只需要下面三项信息:
| 信息 | 值 |
|---|---|
| API 地址 | http://<IP或域名>:18610/v1 |
| API key | m2a_...(显示在页面顶部) |
| Model | muse-spark |
可以使用多个模型名称:常用名称(
gpt-4o, gpt-5,
claude-sonnet-4, deepseek-chat, gemini-2.5-pro)
会被自动映射;muse.ai 会选择合适的能力.
兼容性
| 应用类型 | 使用的 API | 状态 |
|---|---|---|
| 聊天应用 / 网页界面 | POST /v1/chat/completions | ✅ 可用 |
| 流式响应 | stream:true (SSE) | ✅ 可用 |
| 代码提示 | POST /v1/chat/completions | ✅ 可用 |
| 翻译 / 总结 / 讲解 | POST /v1/chat/completions | ✅ 可用 |
| 图片生成应用 | POST /v1/images/generations | ✅ 可用 |
| 视频生成应用 | POST /v1/videos(检查状态) | ✅ 可用 |
| Agent 需要调用工具 | tool_calls / function calling | ⚠️ 暂不支持 |
工具调用的限制: Muse 尚不支持生成工具调用。需要自己读写文件或运行命令的 Agent 暂时用不了.
聊天、编程、翻译、总结、生图和视频仍可正常使用。如果发送
tools 字段,API 会忽略它并按普通对话处理.