OpenCode Zen & Go

OpenCode Zen (pay-per-use) and OpenCode Go (subscription) are model gateways run by the OpenCode team. Both are supported through the ModelConfig::opencode_zen() and ModelConfig::opencode_go() presets.

The gateways serve different model families over different protocols. The presets select the protocol automatically from the model id:

Gemini models on Zen are not supported — Zen serves them over a Google-native endpoint shape yoagent does not target. A gemini-* id falls through to Chat Completions (with a warning logged) and will fail at request time.

The routing table mirrors the Zen/Go endpoint docs as of mid-2026. OpenCode can change gateway-side routing at any time — if a model errors, verify its protocol against {base}/models.

Usage

Agent::from_config selects the built-in provider from the preset's protocol (config.api) and resolves the key from OPENCODE_API_KEY, so the same call works whichever model family you pick:

#![allow(unused)]
fn main() {
use yoagent::provider::ModelConfig;
use yoagent::Agent;

// Chat-completions model (GLM, Kimi, DeepSeek, ...)
let agent = Agent::from_config(ModelConfig::opencode_zen("glm-5.2"));

// Claude/Qwen model — Anthropic Messages protocol
let agent = Agent::from_config(ModelConfig::opencode_zen("claude-sonnet-5"));
}

For OpenCode Go, use ModelConfig::opencode_go("kimi-k2.7-code") — the base URL and protocol map differ, the usage pattern is identical.

Authentication

Both gateways use Authorization: Bearer {api_key}. For the Anthropic-protocol models the presets set AnthropicCompat { bearer_auth: true, .. } so the Anthropic provider sends Bearer auth instead of its native x-api-key header.

Get an API key by signing in at opencode.ai (Zen) or subscribing to Go.

Defaults

The presets use conservative defaults (128K context window, 16K max output). Override the fields for models with larger limits:

#![allow(unused)]
fn main() {
let mut config = ModelConfig::opencode_zen("kimi-k2.7-code");
config.context_window = 256_000;
}

Endpoints

• Zen: https://opencode.ai/zen/v1/{chat/completions | messages | responses}
• Go: https://opencode.ai/zen/go/v1/{chat/completions | messages}

Model list and metadata: https://opencode.ai/zen/v1/models and https://opencode.ai/zen/go/v1/models.