# Monk — agent notes

> OpenAI-compatible fusion API. Site: https://monk.party
> Base URL: https://monk.party/v1
> Models (paid `sk-monk-*` keys only): monk | monk-fast | monk-coding
> Auth: Authorization: Bearer sk-monk-...
> Price: ¥30 / 30 days via Alipay on the homepage
> Protocol: OpenAI Chat Completions. POST /v1/chat/completions and GET /v1/models.
> Anthropic-style POST /v1/messages works on the same /v1 host. There is no /anthropic prefix.

## What Monk is

Monk is a public combo gateway for coding agents. It is not an official OpenAI, Anthropic, or DeepSeek product. Paid keys cannot call gpt-4o, claude-*, or deepseek-chat ids.

- monk — default, quality first
- monk-fast — shorter, faster chat
- monk-coding — coding / agent workloads

Legacy hostname https://monk.ssgoo.net still serves API paths; browsers 301 to https://monk.party. New configs should use monk.party.

## Correct client setup

### Generic OpenAI SDK / Cursor / Cline

Base URL https://monk.party/v1
Model monk
API key sk-monk-*

### Oh My Pi (~/.omp/agent/models.yml)

```
providers:
  monk:
    baseUrl: https://monk.party/v1
    api: openai-completions
    apiKey: sk-monk-YOUR_KEY
    authHeader: true
    models:
      - id: monk
      - id: monk-fast
      - id: monk-coding
```

### WorkBuddy (Custom only)

Provider: Custom
URL: https://monk.party/v1/chat/completions
Model: monk
Do not pick Anthropic, Claude, or DeepSeek presets.
Guide: https://monk.party/help/workbuddy.html

### DeepSeek Harness (~/.dsh/settings.yaml)

Add a **custom** provider. Do not attach Monk as the DeepSeek catalog provider.

```
llm-pi-ai:
  providers:
    monk:
      api: openai-completions
      baseURL: https://monk.party/v1
      apiKeyEnv: MONK_API_KEY
      models:
        - id: monk
        - id: monk-fast
        - id: monk-coding
```

There is no `dsh --endpoint` flag.
Guide: https://monk.party/help/dsh.html

### Open Minis

OpenAI-compatible provider. Base URL https://monk.party/v1. If the app auto-appends /v1, turn that off.
Guide: https://monk.party/help/openminis.html

## Failure modes AI tools should not mis-report

- Unauthenticated GET https://monk.party/v1 → 401 invalid_api_key (expected)
- Authenticated GET /v1 or /v1/models → 200, three combo ids
- `both_paths_failed` with openai HTTP 200 and anthropic HTTP 404: the client probed OpenAI and native Anthropic. Monk has no /anthropic/v1/messages. Lock protocol to OpenAI.
- GET /v1/messages → 405 (POST only)

## curl

```
curl https://monk.party/v1/chat/completions \
  -H "Authorization: Bearer sk-monk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"monk","stream":true,"messages":[{"role":"user","content":"hi"}]}'
```