Skip to main content

长期记忆API 参考

长期记忆的完整 API 接口目录:公共请求信息、全部接口一览与使用限制,各接口的请求参数、返回结果和示例代码见对应分页。

本文档是长期记忆(记忆库)全部 API 的目录总览。功能介绍和使用指南参见记忆库与长期记忆 API。

公共请求信息

参数说明
Base URLhttps://dashscope.aliyuncs.com/api/v2/apps/memory/
认证方式在请求 Header 中添加 Authorization: Bearer $DASHSCOPE_API_KEY。API Key 的获取方式请参见获取 API Key
Content-Typeapplication/json
协议约定、通用请求/响应格式与分页说明参见 API 概览,鉴权细节参见鉴权,错误响应参见错误码。

接口概览

记忆库将于 2026 年 8 月 20 日 10:00(北京时间)正式商业化计费。Add 和 Search 调用均区分 Pro 和 Lite 版本:Add 的版本对应不同质量的记忆抽取模型,Search 的版本决定是否开启 Rerank。详见计费说明。
事实记忆:
接口名称HTTP 方法路径说明
AddMemoryPOST/add添加事实记忆
AddMemoryAsyncPOST/add-async异步提交记忆抽取任务
GetEventGET/events/{event_id}查询异步任务事件详情
ListMemoryGET/memory_nodes列出事实记忆
SearchMemoryPOST/memory_nodes/search搜索事实记忆
GetMemoryNodeGET/memory_nodes/{memory_node_id}获取单个记忆节点详情
GetSkillExportGET/skill/export/{memory_node_id}导出技能记忆节点
UpdateMemoryPATCH/memory_nodes/{memory_node_id}更新事实记忆
DeleteMemoryDELETE/memory_nodes/{memory_node_id}删除事实记忆
用户画像:
接口名称HTTP 方法路径说明
CreateProfileSchemaPOST/profile_schemas创建画像模板
ListProfileSchemasGET/profile_schemas获取画像模板列表
GetProfileSchemaGET/profile_schemas/{profile_schema_id}获取画像模板详情
UpdateProfileSchemaPATCH/profile_schemas/{profile_schema_id}更新画像模板
GetUserProfileGET/profile_schemas/{profile_schema_id}/user_profile获取用户画像

使用限制

限流(阿里云账号级别):
API 接口限流
全部接口总计不超过 3000 QPM
事实记忆 add 接口120 QPM
事实记忆 search 接口300 QPM
生成的记忆片段与用户画像暂无失效日期。如需扩容限流额度,请提交工单申请,详见限流说明。
Managed Agent API
Flow Agent API
Sandbox API
RAG API
长期记忆
ParseX API
Security API
框架集成
Assistant API(下线中)