文档中心

火山方舟

记忆条目

创建记忆

POST https://ark.cn-beijing.volces.com/api/v3/memory_stores/{memory_store_id}/memories

在指定记忆库中创建一条文本记忆。创建后可将该记忆库挂载到会话，供智能体读取或更新其中的记忆。调用前需先创建记忆库，并使用创建或查询记忆库接口返回的 ID。

说明

创建记忆时，响应不返回记忆内容（content）。需要正文时，调用查询记忆详情接口。

创建失败的常见原因：

记忆库不存在或不可访问。

路径格式不合法。

记忆内容不是有效的 UTF-8 文本。

记忆内容超过 100 KiB。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

memory_store_id string 必选 | 记忆库 ID

Body 参数

content string 必选 | 记忆内容

path string 必选 | 记忆路径

响应参数

content_sha256 string | 内容摘要

content_size_bytes integer | 内容字节数

created_at string | 创建时间

created_by object | 创建者

id string | 记忆 ID

memory_store_id string | 记忆库 ID

memory_version_id string | 版本 ID

path string | 记忆路径

type string | 对象类型

updated_at string | 更新时间

创建记忆条目

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/memory_stores/<MEMORY_STORE_ID>/memories" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "path": "/notes/2026/q3-plan.md",
  "content": "Q3 目标：完成托管智能体接口全量上线。"
}
EOF

Response

{
  "id": "mem-<VALUE>",
  "type": "memory",
  "memory_store_id": "<MEMORY_STORE_ID>",
  "path": "/notes/2026/q3-plan.md",
  "content_sha256": "e774ea541686b734b4d19d3460264bc350ecaebef7f45e7ca2bc31a712b2a694",
  "content_size_bytes": 54,
  "memory_version_id": "<MEMORY_VERSION_ID>",
  "created_by": {"type": "user_actor", "user_id": "<USER_ID>"},
  "created_at": "2026-09-17T16:02:50Z",
  "updated_at": "2026-09-17T16:02:51Z"
}

最近更新时间：2026.10.10 17:11:40

这个页面对您有帮助吗？

有用

无用