Chat completions

The single endpoint you call. It mirrors OpenAI's /v1/chat/completions, so existing SDKs and tools work without changes.

Authentication

Every request carries a bearer token in the Authorization header — either a generated client key or the master key:

Authorization: Bearer YOUR_API_KEY

Request body

Other OpenAI fields (temperature, max_tokens, top_p, …) are accepted for compatibility but ignored — the upstream ChatGPT account governs generation.

Message content

content is either a plain string, or an array of parts for multimodal input:

{
  "messages": [
    { "role": "system", "content": "You are concise." },
    { "role": "user", "content": "Summarise the plot of Dune in one line." }
  ]
}

To attach images, use the content-parts form documented in Vision.

Non-streaming response

With stream omitted or false, you get one JSON object in OpenAI's shape:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1733500000,
  "model": "auto",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! How can I help?" },
      "finish_reason": "stop"
    }
  ]
}

Streaming response

With "stream": true, the body is a text/event-stream of chat.completion.chunk deltas, terminated by data: [DONE] — identical to OpenAI, so SDK stream helpers just work:

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"}}]}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello"}}]}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"!"}}]}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

List models

Returns msemax for ChatGPT routing and opencode/muse-spark-1.3-contributor-free for the local OpenCode bridge. A key's model pin takes priority — see Models & keys.

Errors

Errors use standard HTTP status codes with a JSON { "detail": … } body.