> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM Settings & BYOK

> Pick the provider and models your co-founder runs on — optionally with your own API key.

Your co-founder is model-agnostic. You choose the provider and models it thinks with, and optionally bring your own API key (BYOK) so usage is billed to your account with that provider.

## Providers

| Provider        | Default model       | Notes                                    |
| --------------- | ------------------- | ---------------------------------------- |
| OpenAI          | `gpt-5-mini`        | GPT-5 family + o-series reasoning models |
| Anthropic       | `claude-sonnet-4-5` | Sonnet/Opus/Haiku 4.5                    |
| Google Gemini   | `gemini-2.5-pro`    | 1M context                               |
| Kimi (Moonshot) | `kimi-k2.6`         | 256K context, thinking mode              |
| DeepSeek        | `deepseek-chat`     | Cheapest; reasoner variant is text-only  |

Two model slots:

* **Research model** — phase-1 investigation with tools (keyword drills, competitor lookups)
* **Synthesis model** — writes the final schema-validated report and briefing

Most users set both to the same model. Splitting them (cheap research + strong synthesis) is a cost optimization.

## BYOK vs platform key

* **No key stored** → runs are billed against the platform key for your chosen provider.
* **Key stored** → all runs, chat turns, and why-agent analyses use *your* key. The key is encrypted at rest and never returned by the API.

## API

List the catalog:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/cofounder/llm/models
```

Update settings:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X PUT https://api.appeeky.com/v1/cofounder/llm \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "llmProvider": "anthropic",
    "researchModel": "claude-haiku-4-5-20251001",
    "synthesisModel": "claude-sonnet-4-5-20250929",
    "apiKey": "sk-ant-..."
  }'
```

| Field            | Description                                                                                     |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| `llmProvider`    | `openai` / `anthropic` / `google` / `moonshot` / `deepseek`                                     |
| `researchModel`  | Model id from the catalog. Falls back to provider default if it doesn't belong to the provider. |
| `synthesisModel` | Same as above, for the synthesis phase.                                                         |
| `apiKey`         | Optional BYOK key. Stored encrypted.                                                            |
| `clearApiKey`    | `true` to remove a stored key and fall back to the platform key.                                |

You can also change all of this in the dashboard under **Co-founder → Settings**.

## What uses these settings

* Scheduled and manual [runs](../api/runs)
* [Chat / Ask](../capabilities/ask-cofounder) turns
* [Why-agent](../capabilities/why-agent) root-cause analyses
* [Weekly portfolio digest](../capabilities/portfolio-briefing)