summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/zen.mdx
blob: 0b7d1264296253178e5e818399d094580023533f (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
124
125
126
127
128
129
130
131
132
133
---
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            | Model ID         | Endpoint                                      | AI SDK Package              |
| ---------------- | ---------------- | --------------------------------------------- | --------------------------- |
| GPT 5            | gpt-5            | `https://opencode.ai/zen/v1/responses`        | `@ai-sdk/openai`            |
| GPT 5 Codex      | gpt-5-codex      | `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  | -           | -            |
| Kimi K2                           | $0.60  | $2.50  | $0.36       | -            |
| Grok Code Fast 1                  | Free   | Free   | -           | -            |
| Code Supernova                    | Free   | Free   | -           | -            |
| Claude Sonnet 4.5 (≤ 200K tokens) | $3.00  | $15.00 | $0.30       | $3.75        |
| Claude Sonnet 4.5 (> 200K tokens) | $6.00  | $22.50 | $0.60       | $7.50        |
| 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      | -            |
| GPT 5 Codex                       | $1.25  | $10.00 | $0.125      | -            |

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

The free models:

- 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.
- Code Supernova is a stealth model that's free on opencode for a limited time. The team is using this time to collect feedback and improve the model.

:::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.
- Code Supernova: During its free period, collected data may be used to improve
  the model.
- 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.