添加记忆

POST

/save

以增量会话消息的形式写入记忆。

默认 async_exec=true：快速返回、后台处理；传 false 则阻塞至写入完成并返回 messages/medias 详情（含媒体时耗时较长，建议客户端设置不低于 90 秒的超时）。

默认 trigger_schedule_extract=true：保存后自动抽取日程；不需要时传 false。

媒体必须挂在 messages[].medias 下；写在请求体顶层的 medias 字段不会生效。

重复提交相同的消息是幂等的：服务端会自动去重，同步模式下仍返回该消息的详情。

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "user_id": "u001",
    "messages": [
        {
            "role": "user",
            "content": "string",
            "role_name": "string",
            "role_id": "string",
            "id": "string",
            "medias": [
                {
                    "url": "string",
                    "data": "string",
                    "mime_type": "image/png",
                    "description": "string",
                    "file_name": "string",
                    "meta": {
                        "property1": "string",
                        "property2": "string"
                    }
                }
            ],
            "idempotency_key": "string"
        }
    ],
    "occurred_at": "2026-01-01T09:00:00",
    "session_id": "s001",
    "source": "string",
    "async_exec": true,
    "trigger_schedule_extract": true,
    "memory_key": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ms.seemem.com/api/v2/memory/save' \
--header 'Authorization: Bearer <tenant token>' \
--header 'Content-Type: application/json' \
--data '{
    "user_id": "u001",
    "messages": [
        {
            "role": "user",
            "content": "string",
            "role_name": "string",
            "role_id": "string",
            "id": "string",
            "medias": [
                {
                    "url": "string",
                    "data": "string",
                    "mime_type": "image/png",
                    "description": "string",
                    "file_name": "string",
                    "meta": {
                        "property1": "string",
                        "property2": "string"
                    }
                }
            ],
            "idempotency_key": "string"
        }
    ],
    "occurred_at": "2026-01-01T09:00:00",
    "session_id": "s001",
    "source": "string",
    "async_exec": true,
    "trigger_schedule_extract": true,
    "memory_key": "string"
}'

返回响应

🟢200

application/json

统一包裹响应

Bodyapplication/json

示例

成功（同步模式）成功（异步模式）

{
    "code": 0,
    "msg": "成功",
    "data": {
        "external_session_id": "s001",
        "internal_session_id": "01KTTFWE1PXQK4D9S6693HT1DN",
        "segment_index": 0,
        "tokens": 109,
        "async_exec": false,
        "messages": [
            {
                "id": "01KTTFWE1T6X3H5Z6M5FCK9VTV",
                "role": "user",
                "content": "今天开了项目评审",
                "role_name": "小明",
                "role_id": "xxx_1",
                "timestamp": "2026-06-11 09:30:00",
                "ingested_at": "2026-06-11 12:43:39"
            }
        ],
        "medias": []
    }
}

🟠400BadRequest

🟠415UnsupportedMediaType

修改于 2026-09-11 10:51:04

极速召回记忆（Flash Recall）

查询时间段会话摘要