// for developers

The Local API

Updated 2026-11-16 · M1K3 for Mac, version 1.4 and later

Short answer: M1K3 on the Mac can lend the brain it already has loaded to any tool that speaks the OpenAI API. Switch on Settings ▸ Server ▸ Local API, copy the key, and point your editor, script or client library at http://127.0.0.1:4141/v1. It is off by default, it listens on your Mac only, and it has a key of its own. A caller gets the raw brain under its own instructions: none of M1K3's memory, knowledge, personality or tools.

Set it up

  1. Open M1K3 on your Mac and go to Settings ▸ Server ▸ Local API. Switch it on.
  2. Copy the API key from the same pane. You can make a new key there at any time; the old one stops working.
  3. Point your tool at the base URL below and give it the key.
Base URL   http://127.0.0.1:4141/v1
API key    Settings ▸ Server ▸ Local API ▸ API key ▸ Copy
Model      mini-m1k3, lil-m1k3 or big-m1k3: whichever brain M1K3 has ready

A first call

With curl, streaming:

$ curl http://127.0.0.1:4141/v1/chat/completions \
    -H "Authorization: Bearer $M1K3_API_KEY" -H "Content-Type: application/json" \
    -d '{"model":"lil-m1k3","stream":true,"messages":[{"role":"user","content":"Hello"}]}'

With the OpenAI Python client. The brain on this Mac is always the first model listed, so you do not have to know which one is loaded:

from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:4141/v1", api_key="<the key from Settings>")
models = [m.id for m in client.models.list()]
reply = client.chat.completions.create(
    model=models[0],
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(reply.choices[0].message.content)

The model names

Model idWhat answersWhere
mini-m1k3Mini: Apple's on-device modelOn this Mac
lil-m1k3Lil: Qwen3.5 4B on MLXOn this Mac
big-m1k3Big: Gemma 4 12B on MLXOn this Mac
cloud-m1k3Apple's Private Cloud ComputeLeaves the Mac. Off until you switch it on.

/v1/models lists the brain that is ready. Asking for another one returns 404 model_not_found; switch brain in M1K3 itself. Which models these are, and how they score.

The rules

What it serves, and what it refuses

GET /v1/modelsThe ready brain, then cloud-m1k3 if you offer it
POST /v1/chat/completionsText chat, streamed or whole
Honouredmessages (system, developer, user, assistant), max_tokens, temperature, stop (up to four), stream_options.include_usage
Refused with a 400tools and functions, n above 1, image or audio content, tool messages, JSON-schema response formats
Not offered (404)/v1/completions, /v1/embeddings, /v1/responses, audio and image endpoints

Errors use OpenAI's shape. The full reference, with usage counts and finish reasons, is LOCAL_API.md in the repository.

The cloud model: Private Cloud Compute

For a job bigger than your Mac, there is one optional model that leaves it. Switch on Also offer Private Cloud Compute in the same pane (it also needs Settings ▸ Privacy ▸ Private Cloud Compute on, and the App Store build with Apple Intelligence), and /v1/models gains cloud-m1k3. A call that names it is answered by Apple's Private Cloud Compute.

What Apple promises about Private Cloud Compute is on Apple's own page. M1K3 makes no claim beyond it. The privacy page has the same account in the policy's words.

Want the assistant, not the raw brain?

Memory, document search and voice live behind M1K3's MCP server, which has its own switch and its own token. Connect a coding agent, or read how Claude gets a local memory.

Questions

Does M1K3 have an OpenAI-compatible API?

Yes, on the Mac, from version 1.4. Switch on Settings ▸ Server ▸ Local API and M1K3 serves /v1/models and /v1/chat/completions at http://127.0.0.1:4141/v1, in the shape OpenAI clients already speak. It is off by default and has its own key.

Does anything I send leave my Mac?

Not with the on-device brains: the listener binds 127.0.0.1 only, refuses web pages, and a call to mini-m1k3, lil-m1k3 or big-m1k3 is answered on the Mac. The one exception is cloud-m1k3, which you have to switch on yourself: a call that names it sends that call's messages to Apple's Private Cloud Compute.

Which model names does it serve?

Whichever brain M1K3 has ready: mini-m1k3 (Apple's on-device model), lil-m1k3 (Qwen3.5 4B) or big-m1k3 (Gemma 4 12B). Ask /v1/models and use the first id. Asking for a brain that is not loaded returns 404 model_not_found; switch brain in M1K3 itself.

Does it support tool calls, embeddings or images?

Not in this version. It serves text chat, streamed or whole. Tools, functions, image and audio content and JSON-schema response formats are refused with a 400, and /v1/embeddings, /v1/completions and /v1/responses are not offered.

How is this different from M1K3's MCP server?

The Local API lends the raw brain: your system message, your messages, and none of M1K3's memory, knowledge, personality or tools. The MCP server is the assistant itself for agents: memory, document search and voice. They have separate switches and separate keys.

Does it work on iPhone or iPad?

No. The Local API is part of M1K3 on the Mac.

// try it

Get M1K3 for your Mac.

Free for humans, source-available. The Local API is in the app, off until you switch it on.