Connect a client
Any OpenAI-compatible client
Use MarkDB from the OpenAI SDK or any compatible tool.
Any tool that talks to an OpenAI-compatible endpoint works with MarkDB. Set the
base URL to the proxy and use your mk_live_... key.
OpenAI SDK (Python)
from openai import OpenAI
client = OpenAI(
base_url="https://proxy.markdb.cloud/v1",
api_key="mk_live_xxx",
)
resp = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)OpenAI SDK (Node)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://proxy.markdb.cloud/v1",
apiKey: process.env.MARKDB_API_KEY,
});
const resp = await client.chat.completions.create({
model: "gemini-2.5-flash",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);Chat continuity for custom clients
If your client manages its own conversation ids, pass one so MarkDB groups turns
into the right session. You can supply it via the X-MarkDB-Chat-Key header or a
markdb_chat_key field in the request body. If you don't, MarkDB derives a
stable key from the opening messages.
See the API reference for the supported surfaces and headers.