服务地址、协议约定、请求格式与通用响应
通过记忆库 API，你可以以编程方式写入记忆、检索记忆、管理画像模板。所有接口通过 DashScope 网关提供服务。
所有接口使用统一的服务地址。将各接口页面列出的路径拼接到服务地址后即可得到完整请求地址，例如
成功响应的公共字段只有
失败响应：
排查问题时，请提供
列表接口支持分页查询：
服务地址
/add 对应 https://dashscope.aliyuncs.com/api/v2/apps/memory/add。
协议约定
- 所有接口均通过 HTTPS 访问，不支持 HTTP
- 请求体和响应体均为 JSON 格式，字符集 UTF-8
- 写入和检索接口使用
POST方法；列表查询使用GET方法；更新使用PATCH；删除使用DELETE
通用请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer $DASHSCOPE_API_KEY，获取方式见鉴权 |
Content-Type | 仅含请求体的接口必填 | application/json |
通用响应格式
成功响应的公共字段只有 request_id，其他业务字段因接口而异，请以对应接口页面为准。
成功响应：
request_id，以便技术支持快速定位。错误处理建议见错误码。
分页
列表接口支持分页查询：
| 参数 | 说明 |
|---|---|
page_size | 每页数量 |
page_num | 页码，从 1 开始 |
记忆库将于 2026 年 8 月 20 日 正式商业化计费。Add 和 Search 调用区分 Pro 和 Lite 两个策略版本。详见计费说明。