Copy

记忆库（长期记忆）提供完整的开放 API，覆盖事实记忆的写入、检索、更新、删除，以及用户画像模板管理和画像获取。所有接口通过 DashScope 网关提供服务，服务地址为 https://dashscope.aliyuncs.com/api/v2/apps/memory/，采用 API Key 鉴权，详见鉴权。

接口一览

事实记忆：

接口	方法	路径	说明
AddMemory	POST	`/add`	添加记忆，自动提取关键信息
AddMemoryAsync	POST	`/add-async`	异步提交记忆抽取任务
GetEvent	GET	`/events/{event_id}`	查询异步任务事件详情
ListMemory	GET	`/memory_nodes`	分页列出记忆
SearchMemory	POST	`/memory_nodes/search`	基于语义检索历史记忆
GetMemoryNode	GET	`/memory_nodes/{memory_node_id}`	获取单个记忆节点详情
GetSkillExport	GET	`/skill/export/{memory_node_id}`	导出技能记忆节点
UpdateMemory	PATCH	`/memory_nodes/{memory_node_id}`	更新记忆内容
DeleteMemory	DELETE	`/memory_nodes/{memory_node_id}`	删除记忆

用户画像：

接口	方法	路径	说明
CreateProfileSchema	POST	`/profile_schemas`	创建画像模板
ListProfileSchemas	GET	`/profile_schemas`	列出画像模板
GetProfileSchema	GET	`/profile_schemas/{profile_schema_id}`	获取画像模板详情
UpdateProfileSchema	PATCH	`/profile_schemas/{profile_schema_id}`	更新画像模板
GetUserProfile	GET	`/profile_schemas/{profile_schema_id}/user_profile`	获取用户画像

最小调用示例

写入记忆（AddMemory）：

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/add \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "messages": [
      {"role": "user", "content": "每天上午9点提醒我喝水"},
      {"role": "assistant", "content": "好的，已记录"}
    ],
    "user_id": "user_001"
  }'

检索记忆（SearchMemory）：

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "messages": [
      {"role": "user", "content": "我需要做什么？"}
    ]
  }'

使用限制

全部接口总计不超过 3000 QPM（阿里云账号级别），事实记忆 add 接口 120 QPM，search 接口 300 QPM。详见限流说明。

按接口分页的参数、返回结果和 Python 示例，参见长期记忆 API 参考；端到端上手流程参见快速开始，功能与控制台操作参见记忆库。

​接口一览

​最小调用示例

​使用限制

接口一览

最小调用示例

使用限制