Chat Completions - MemoryLake AI

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/router/openai/v1/chat/completions?boundary_id=bnd-xxxxxx' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "messages": [
      {
        "content": "What did I say my favourite city was?",
        "role": "user"
      }
    ],
    "model": "gpt-4o-mini"
  }'

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "You said your favourite city is Lisbon.",
        "role": "assistant"
      }
    }
  ],
  "created": 1760000000,
  "id": "chatcmpl-abc123",
  "model": "gpt-4o-mini",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 11,
    "prompt_tokens": 412,
    "total_tokens": 423
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/router/openai/v1/chat/completions?boundary_id=bnd-xxxxxx' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "messages": [
      {
        "content": "What did I say my favourite city was?",
        "role": "user"
      }
    ],
    "model": "gpt-4o-mini"
  }'

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "You said your favourite city is Lisbon.",
        "role": "assistant"
      }
    }
  ],
  "created": 1760000000,
  "id": "chatcmpl-abc123",
  "model": "gpt-4o-mini",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 11,
    "prompt_tokens": 412,
    "total_tokens": 423
  }
}

POST /openapi/memorylake/router/openai/v1/chat/completions

OpenAI Chat Completions. With boundary_id, memories from that Boundary are added to the conversation before the model is called. Without it, the request goes to the model as is. Set stream to true to receive server-sent events in the OpenAI format. Parameters not listed below are passed to the model unchanged.

Query Parameters

string

The Boundary whose memory this request uses. Omit it to call the model without memory.

Headers

string

Your MemoryLake API key, when you call the model with your own provider key. The provider key then goes in the provider’s usual key header. Your provider key is forwarded to the provider and never stored.

string

W3C trace context. When present, the request joins your trace and the same trace id comes back in X-Trace-ID.

Request Body

array

required

The conversation so far

Show Chat Message object

string | array

required

Message text, or an array of content parts

string

required

Who wrote the message. One of: system, developer, user, assistant, tool.

string

required

Model name, as listed under Available Models in the console

integer

Maximum tokens to generate, reasoning included. Use this instead of max_tokens for the gpt-5 and o-series models.

integer

Maximum tokens to generate

boolean

default:"false"

Stream the reply as server-sent events

number

Sampling temperature

array

Tools the model may call, in the OpenAI format

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/router/openai/v1/chat/completions?boundary_id=bnd-xxxxxx' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "messages": [
      {
        "content": "What did I say my favourite city was?",
        "role": "user"
      }
    ],
    "model": "gpt-4o-mini"
  }'

Response

array

The generated replies

Show Choice object

string

Why the model stopped, such as stop or length

integer

Position in the list

object

The reply

Show Message object

string

Reply text

string

Always assistant

integer

Creation time, Unix seconds

string

Completion id

string

Model that answered

string

Always chat.completion

object

Tokens used

Show Chat Usage object

integer

Tokens in the reply

integer

Tokens in the prompt

integer

Prompt and reply together

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "You said your favourite city is Lisbon.",
        "role": "assistant"
      }
    }
  ],
  "created": 1760000000,
  "id": "chatcmpl-abc123",
  "model": "gpt-4o-mini",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 11,
    "prompt_tokens": 412,
    "total_tokens": 423
  }
}

​Query Parameters

​Headers

​Request Body

​Response

Query Parameters

Headers

Request Body

Response