Skip to main content
MEMO API 是咏唱引擎 AriaMem 云端知识记忆融合平台的 REST 接口。AriaMem 把「知识库」与「记忆」统一在一套工作空间里：你上传文档、抽取记忆立方、让 Agent 在对话里沉淀分层记忆，并把知识记忆双向转换、沉淀成可回滚的 Wiki。 所有接口都以 /v1 为前缀，统一用 JWT 或 API Key 认证，并按工作空间做 RBAC。直接调 REST 即可，下面的示例都用 curl。

认证

Bearer JWT 与 X-API-Key 两种方案，密钥可自助管理

工作空间

创建隔离租户，邀请成员并分配角色

知识库

建库、上传文档、检索并基于文档问答

记忆立方

创建记忆立方体，增删节点、连边并语义检索

​
基础 URL

海外站点请使用 https://memo.ariacompute.com。 自托管 AriaMem（Docker，端口 8010，路径 /ariamem/）时，把上面的主机替换成你的部署地址即可，路径与参数完全一致。

​
认证

在 Authorization 头里传 JWT，或在 X-API-Key 头里传 API Key：
  • Authorization: Bearer <jwt>
  • X-API-Key: <sk_aria_...>
取得 JWT：先 POST /v1/auth/login，用邮箱密码换 token；或 POST /v1/auth/register 注册账号。API Key 在 POST /v1/apikeys 自助创建（仅展示一次）。完整说明见认证。

​
工作空间与 RBAC

除认证接口外，所有业务接口都挂在某个工作空间之下（/v1/workspaces/:workspace_id/...）。调用前要先有工作空间（创建工作空间），并按角色访问： 角色不足会返回 403 Forbidden。

​
错误格式

错误返回 HTTP 状态码，外加统一的 JSON 信封：
常见状态码：400 参数错误、401 未认证、403 角色不足、404 资源不存在、500 服务端错误。

​
版本管理

当前接口以 /v1 为前缀。本参考逐条覆盖 ariamem 后端的全部 /v1 业务接口（认证、工作空间、知识库、记忆立方、知识记忆转换、分层对话记忆、技能、代码图谱、智能体编队、资产中心与 Wiki）。