curl https://mdb.ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MINDS_API_KEY" \
-d '{
  "model": "<name of the mind that you created>",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Can you summarize the data you have access to?"
    }
  ],
  "stream": false
}'

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1702685778,
  "model": "<name of the mind that you created>",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I have access to sales data, customer info, and website analytics. Let me know if you need details!"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 9,
    "total_tokens": 18
  },
  "system_fingerprint": null
}
This API endpoint creates a model response for the given chat conversation using the POST method.

​
Body

​
messages
array
required
A list of messages comprising the conversation so far.
​
model
string
required
Name of the Mind that you created.
​
stream
boolean
If set, Minds’ thoughts will be streamed before the final response.
​
frequency_penalty
number
This setting ranges from -2.0 to 2.0. Positive values make the model less likely to repeat phrases it has already used.
​
max_tokens
integer
This parameter sets the maximum number of tokens that can be generated in the chat completion.
​
temperature
number
This parameter controls the randomness of the output with values ranging from 0 to 2. A higher value increases randomness in the output, while a lower value, like 0.1, results in more focused and deterministic output.
​
tools
array
This setting allows you to specify a list of tools that the model can call, currently limited to functions.

​
Response

​
id
string
required
Unique identifier for the completion.
​
object
string
required
Type of the returned object (e.g., “chat.completion”).
​
created
integer
required
Timestamp for when the completion was created.
​
model
string
required
Name of the model that generated the response.
​
choices
array
required
An array of response choices. Each choice includes an index and the assistant’s message.
​
usage
object
Token usage statistics for the prompt and response.
​
system_fingerprint
string
Optional fingerprint of the backend system.

​
Authorization

A valid API key must be passed in the Authorization header: 
Authorization: Bearer MINDS_API_KEY
Generate your API key here.

​
Path Parameters

None. 
curl https://mdb.ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MINDS_API_KEY" \
-d '{
  "model": "<name of the mind that you created>",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Can you summarize the data you have access to?"
    }
  ],
  "stream": false
}'

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1702685778,
  "model": "<name of the mind that you created>",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I have access to sales data, customer info, and website analytics. Let me know if you need details!"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 9,
    "total_tokens": 18
  },
  "system_fingerprint": null
}