> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# MEMO API 概览：AriaMem 知识记忆平台

> 咏唱引擎 MEMO API 提供 AriaMem 云端知识记忆融合平台的 REST 接口，覆盖工作空间、知识库、记忆立方、对话记忆、技能、代码图谱、智能体编队与 Wiki，统一用 JWT 或 API Key 认证。

MEMO API 是咏唱引擎 **AriaMem** 云端知识记忆融合平台的 REST 接口。AriaMem 把「知识库」与「记忆」统一在一套工作空间里：你上传文档、抽取记忆立方、让 Agent 在对话里沉淀分层记忆，并把知识记忆双向转换、沉淀成可回滚的 Wiki。

所有接口都以 `/v1` 为前缀，统一用 JWT 或 API Key 认证，并按工作空间做 RBAC。直接调 REST 即可，下面的示例都用 `curl`。

<CardGroup cols={2}>
  <Card title="认证" icon="key" href="/api-reference/memo/authentication">
    Bearer JWT 与 X-API-Key 两种方案，密钥可自助管理
  </Card>

  <Card title="工作空间" icon="building" href="/api-reference/memo/workspaces/create">
    创建隔离租户，邀请成员并分配角色
  </Card>

  <Card title="知识库" icon="book" href="/api-reference/memo/kbs/create">
    建库、上传文档、检索并基于文档问答
  </Card>

  <Card title="记忆立方" icon="cube" href="/api-reference/memo/cubes/create">
    创建记忆立方体，增删节点、连边并语义检索
  </Card>
</CardGroup>

## 基础 URL

```text theme={null}
https://memo.ariacompute.cn
```

海外站点请使用 `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`](/api-reference/memo/auth/login)，用邮箱密码换 `token`；或 [`POST /v1/auth/register`](/api-reference/memo/auth/register) 注册账号。API Key 在 [`POST /v1/apikeys`](/api-reference/memo/apikeys/create-list) 自助创建（仅展示一次）。完整说明见[认证](/api-reference/memo/authentication)。

## 工作空间与 RBAC

除认证接口外，所有业务接口都挂在某个工作空间之下（`/v1/workspaces/:workspace_id/...`）。调用前要先有工作空间（[创建工作空间](/api-reference/memo/workspaces/create)），并按角色访问：

| 角色 | 能力 |
| - | - |
| `owner` | 完全控制，含审计与成员管理 |
| `admin` | 读写 + 审计查看 |
| `contributor` | 可读写内容与记忆 |
| `viewer` | 只读 |

角色不足会返回 `403 Forbidden`。

## 错误格式

错误返回 HTTP 状态码，外加统一的 JSON 信封：

```json theme={null}
{
  "error": {
    "message": "Description of what went wrong",
    "type": "400 Bad Request"
  }
}
```

常见状态码：`400` 参数错误、`401` 未认证、`403` 角色不足、`404` 资源不存在、`500` 服务端错误。

## 版本管理

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.