POST https://ark.cn-beijing.volces.com/api/v3/memory_stores/{memory_store_id}/memories/batch_create
在指定记忆库中批量创建多条文本记忆，适合一次导入多个文件。仅写入一条时，可使用创建记忆接口。调用前需先创建记忆库，并使用创建或查询记忆库接口返回的 ID。
鉴权#
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数#
Path 参数#
memory_store_id string 必选 | 记忆库 ID
用于指定目标记忆库，以 memstore- 开头。传入创建或查询记忆库接口返回的完整 ID，不要自行拼接。
Body 参数#
items object[] 必选 | 记忆列表
本次批量创建的记忆条目。
content string 必选 | 记忆内容
items.content
写入记忆文件的正文。
path string 必选 | 记忆路径
items.path
记忆在记忆库中的文件路径。
on_conflict string 默认值 overwrite | 冲突策略
指定目标 path 已存在同名记忆时的处理方式：
overwrite：用新内容覆盖已有记忆，并更新其当前版本标识。fail：保留已有记忆，该条目返回冲突错误，其他条目继续处理。
响应参数#
results object[] | 创建结果
各条记忆的创建结果，与请求 items 顺序一一对应。成功时返回 memory，失败时返回 error。
path string | 记忆路径
results.path
对应请求中的 items[].path，用于关联输入条目和创建结果。
error object | 错误信息
results.error
该条记忆失败时的错误信息；成功时不返回。
message string | 错误描述
results.error.message
该条记忆失败的原因说明，用于定位并修正输入。
type string | 错误类型
results.error.type
错误类型标识，用于分类该条记忆的失败原因。
memory object | 记忆详情
results.memory
成功创建或覆盖后的记忆详情；该条记忆失败时不返回。
content_sha256 string | 内容摘要
results.memory.content_sha256
记忆正文的 SHA-256 摘要，以小写十六进制字符串表示，可用于校验内容完整性。
content_size_bytes integer | 内容字节数
results.memory.content_size_bytes
记忆正文采用 UTF-8 编码后的字节数。
created_at string | 创建时间
results.memory.created_at
记忆创建时间，采用 RFC 3339 UTC 格式。
created_by object | 创建者
results.memory.created_by
创建该记忆的操作者信息。
type string | 操作者类型
results.memory.created_by.type
操作者类型。user_actor 表示通过用户身份写入，session_actor 表示会话中的智能体写入。
session_id string | 会话 ID
results.memory.created_by.session_id
写入该记忆的会话 ID，仅 type 为 session_actor 时返回。
user_id string | 用户 ID
results.memory.created_by.user_id
写入该记忆的用户 ID，仅 type 为 user_actor 时返回。
id string | 记忆 ID
results.memory.id
服务端生成的记忆 ID，以 mem- 开头。后续查询、更新或删除记忆时，作为 memory_id 路径参数传入。
memory_store_id string | 记忆库 ID
results.memory.memory_store_id
该记忆所属的记忆库 ID。
memory_version_id string | 版本 ID
results.memory.memory_version_id
记忆条目的当前版本标识。内容或路径成功更新后，该值会变化。
path string | 记忆路径
results.memory.path
记忆在记忆库中的文件路径。
type string | 对象类型
results.memory.type
对象类型，固定为 memory。
updated_at string | 更新时间
results.memory.updated_at
记忆最后更新时间，采用 RFC 3339 UTC 格式。