API 参考

FishMem REST API 使用常见记忆操作与 mem0 风格作用域名，但客户端必须以本参考作为契约。现有 mem0 或图记忆集成可能需要修改响应处理与行为；请先阅读从 mem0 迁移或从 Zep/Graphiti 迁移。

Base URL 与认证

Cloud 使用 https://fishmem.com/v1；自托管使用你的部署 origin 加 /v1。除公开 OpenAPI 外，请求通过项目 Key 认证：

Authorization: Bearer fm_...
Content-Type: application/json

Key 决定项目边界并在数据层限制所有资源。它必须留在服务端，不可放进浏览器或查询字符串。

记忆对象

公开对象包含 id、memory、结构化作用域、metadata、memory_type、importance、有效时间与记录时间、创建/更新时间，以及可选相关性 score。内部项目键与供应商载荷不会返回。

错误

{
  "code": "INVALID_REQUEST",
  "message": "One of user_id, agent_id, run_id is required",
  "request_id": "req_...",
  "details": {}
}

保存 request_id 用于排障，但不要记录完整 API Key 或敏感负载。

额度

端点