summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/zen.mdx
blob: b43801b5a52e968e52e8e2a2723a50bcaa4a86d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
---
title: Zen
description: Curated list of models provided by opencode.
---

import config from "../../../config.mjs"
export const console = config.console
export const email = `mailto:${config.email}`

opencode zen is a list of tested and verified models provided by the opencode team.

:::note
opencode zen is currently in beta.
:::

Zen works like any other provider in opencode. You login to opencode zen and get
your API key. It's **completely optional** and you don't need to use it to use
opencode.

---

## Background

There are a large number of models out there but only a few of
these models work well as coding agents. Additionally, most providers are
configured very differently; so you get very different performance and quality.

:::tip
We tested a select group of models and providers that work well with opencode.
:::

So if you are using a model through something like OpenRouter, you can never be
sure if you are getting the best version of the model you want.

To fix this, we did a couple of things:

1. We tested a select group of models and talked to their teams about how to
   best run them.
2. We then worked with a few providers to make sure these were being served
   correctly.
3. Finally, we benchmarked the combination of the model/provider and came up
   with a list that we feel good recommending.

opencode zen is an AI gateway that gives you access to these models.

---

## How it works

opencode zen works like any other provider in opencode.

1. You sign in to **<a href={console}>opencode zen</a>**, add your billing
   details, and copy your API key.
2. You run `opencode auth login`, select opencode, and paste your API key.
3. Run `/models` in the TUI to see the list of models we recommend.

You are charged per request and you can add credits to your account.

---

## Endpoints

You can also access our models through the following API endpoints.

| Model            | Mode ID          | Endpoint                                      | AI SDK Package              |
| ---------------- | ---------------- | --------------------------------------------- | --------------------------- |
| GPT-5            | gpt-5            | `https://opencode.ai/zen/v1/responses`        | `@ai-sdk/openai`            |
| Claude Sonnet 4  | claude-sonnet-4  | `https://opencode.ai/zen/v1/messages`         | `@ai-sdk/anthropic`         |
| Claude Haiku 3.5 | claude-3-5-haiku | `https://opencode.ai/zen/v1/messages`         | `@ai-sdk/anthropic`         |
| Claude Opus 4.1  | claude-opus-4-1  | `https://opencode.ai/zen/v1/messages`         | `@ai-sdk/anthropic`         |
| Qwen3 Coder 480B | qwen3-coder      | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
| Grok Code Fast 1 | grok-code        | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
| Kimi K2          | kimi-k2          | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |

---

## Pricing

We support a pay-as-you-go model. Below are the prices **per 1M tokens**.

| Model                           | Input  | Output | Cached Read | Cached Write |
| ------------------------------- | ------ | ------ | ----------- | ------------ |
| Qwen3 Coder 480B                | $0.45  | $1.50  | -           | -            |
| Grok Code Fast 1                | Free   | Free   | Free        | -            |
| Claude Sonnet 4 (≤ 200K tokens) | $3.00  | $15.00 | $0.30       | $3.75        |
| Claude Sonnet 4 (> 200K tokens) | $6.00  | $22.50 | $0.60       | $7.50        |
| Claude Haiku 3.5                | $0.80  | $4.00  | $0.08       | $1.00        |
| Claude Opus 4.1                 | $15.00 | $75.00 | $1.50       | $18.75       |
| GPT 5                           | $1.25  | $10.00 | $0.125      | -            |
| Kimi K2                         | $0.60  | $2.50  | -           | -            |

:::note
Credit card fees are passed along at cost; we don’t charge anything beyond that.
:::

Grok Code Fast 1 is currently free on opencode for a limited time. The xAI team is using this time to collect feedback and improve Grok Code.

:::tip
Subscription plans and a free tier are coming soon.
:::

<a href={email}>Contact us</a> if you have any questions.

---

## Privacy

All our models are hosted in the US. Our providers follow a zero-retention policy and do not use your data for model training, with the following exceptions:

- Grok Code Fast 1: During its free period, collected data may be used to improve Grok Code.
- OpenAI APIs: Requests are retained for 30 days in accordance with [OpenAI's Data Policies](https://platform.openai.com/docs/guides/your-data).
- Anthropic APIs: Requests are retained for 30 days in accordance with [Anthropic's Data Policies](https://docs.anthropic.com/en/docs/claude-code/data-usage).

---

## Goals

We created opencode zen to:

1. **Benchmark** the best models/providers for coding agents.
2. Have access to the **highest quality** options and not downgrade performance or route to cheaper providers.
3. Pass along any **price drops** by selling at cost; so the only markup is to cover our processing fees.
4. Have **no lock-in** by allowing you to use it with any other coding agent. And always let you use any other provider with opencode as well.