boundary_id:调用模型前,相关记忆会被加入提示词。
请求和响应保持模型厂商自己的格式。本参考只说明 Memory Router 新增的部分;其余字段请参阅模型厂商的 API 文档。分步上手请看快速入门。
Base URL
Memory Router 与 MemoryLake API 其余部分使用同一个 Base URL
https://app.memorylake.cn/openapi/memorylake,位于其中独立的 /router 段。
早先的端点
https://app.memorylake.cn/openai/v1/… 与 https://app.memorylake.cn/anthropic/v1/messages 继续可用、行为相同。新接入请使用上面的路径。端点
身份验证
每个请求都需要一个 MemoryLake API Key(sk-...)。它放在哪里,取决于由谁的模型账号付费:
您的模型厂商密钥只会转发给模型厂商,不会被保存。详见部署模式。
记忆
boundary_id 是查询参数,不是请求头,也不是请求体字段:
boundary_id 适用于 Chat Completions、Responses 和 Messages。不带 boundary_id 时,请求原样发给模型,不使用记忆;它仍会鉴权并计量。详见工作原理。
模型
使用模型的原生名称,例如gpt-4o-mini 或 claude-haiku-4-5,不加厂商前缀。列出模型会返回全部可调用的模型,以及各自经哪个 base URL 调用。OpenAI 与 Anthropic 的 /v1/models 端点不可用。
流式输出
设置stream: true 即可按模型厂商的格式接收 server-sent events。事件到达即转发。
链路追踪
每个响应都带有X-Trace-ID 响应头。发送 W3C traceparent 请求头,即可把该请求纳入您自己的链路。联系支持团队时请提供该 trace id。
错误
列出模型与其他 MemoryLake 接口一样,使用 MemoryLake API 的响应格式:出错时返回success: false、message 和 error_code。详见错误码。
推理端点保持模型厂商的格式。这些端点上由 Memory Router 自身返回的错误:
401 和 403 使用 OpenAI 的错误格式({"error": {"message", "type"}})。402 返回 {"success": false, "message": "insufficient quota"}。429 返回 {"success": false, "code": "AUTH_THROTTLED", "action", "error": {"type", "message"}}。502 返回纯文本。503 返回 {"success": false, "message", "code": "REQUEST_BLOCKED"}。
其余错误由上游原样透传;来自模型厂商的错误保持厂商自有格式。