01 / 获取测试 Key
由管理员提供绑定用户范围的凭证。当前没有自助注册入口,可通过公开邮箱讨论接入。
Key 仅放在应用服务端或本机环境变量中,不嵌入网页、代码仓库或公开截图。
由管理员提供绑定用户范围的凭证。当前没有自助注册入口,可通过公开邮箱讨论接入。
使用下面的 JavaScript 或 REST 示例,仅替换用户范围和环境变量。先使用合成数据。
在控制台检查来源、当前版本和历史。需要删除时提供当前版本号。
import { SixteenMemory } from "./sixteen-memory-sdk.mjs";
const memory = new SixteenMemory({
baseUrl: "https://console.sixteenmemory.com",
apiKey: process.env.SIXTEEN_API_KEY
});
await memory.add({
request_id: "synthetic-ticket-884",
user_id: "customer-42",
content: "Replacement shipped; refund still open.",
source: {
type: "business",
ref: "synthetic-ticket-884",
text: "Replacement shipped; refund still open.",
observed_at: "2026-11-05T09:00:00Z"
},
expires_at: null
});
const results = await memory.search({
user_id: "customer-42",
query: "refund open",
limit: 10
});/v1/memories新增
/v1/search检索
/v1/memories列表
/v1/memories/:id读取
/v1/memories/:id更新
/v1/memories/:id/history历史
/v1/memories/:id/revoke停用
/v1/memories/:id删除
/v1/export导出
保持请求 ID 稳定可避免相同请求重复保存。相同 ID 改了内容会返回冲突,不应无限重试。
| 字段 | 含义 |
|---|---|
user_id | Key 允许访问的用户标识 |
request_id | 新增请求的唯一标识;同请求重试保持不变 |
content | 要保存的记忆正文,最多 8,000 字符 |
source | type、ref、text、observed_at:来源类型、标识、正文和时间 |
expires_at | 可选到期时间;不设置时为 null |
expected_version | 更新、停用或删除时提供当前版本 |
客户端保留 HTTP 状态和 error.code。不要把权限失败、版本冲突或缺少模型配置当成网络重试问题。
401检查凭证是否缺失、无效或已退出。
403 / 404确认角色与用户范围;不要尝试绕过权限。
409重新读取当前版本,或检查请求 ID 是否用于不同内容。
422按字段说明检查内容、来源、标识和日期格式。
429按 Retry-After 等待,降低请求频率。
503服务或模型配置暂不可用,先检查配置和服务状态。