Model Presets

yoagent's first-class model presets are the ModelConfig::* constructors. A preset sets provider routing, base URL, context metadata, default output limits, and provider compatibility flags.

Use a preset when the provider is listed here. Use a custom ModelConfig when you need a compatible provider or endpoint that does not have a constructor yet.

First-Class Constructors

The generic constructors (google(id, name), xai, mistral, …) assume conservative limits; for a model with a named preset, use the preset — it carries the model's real context window and output limit (a generic ModelConfig::xai("grok-4.7", ..) compacts at 131K and stops replies at 4,096 tokens). The constructors do not validate model IDs. They send the id you pass through to the provider, which lets you use newly released model IDs before yoagent updates its examples.

Nothing is priced until the process opts in — prices::enable_bundled() (the bundled data file src/provider/prices.json, offline) or prices::enable_live(..) (native) — see Model Pricing. After that, prices are looked up by (provider, id) when the config is built. The named presets (claude_fable_5, claude_fable_5_1, claude_opus_5_5, claude_opus_5, claude_opus_4_8, claude_sonnet_5, claude_sonnet_5_5, claude_haiku_5_5, claude_haiku_4_5, gpt_5_5, gpt_6_astra, gpt_6_sol, gpt_6_1_sol, gpt_6_luna, gemini_4_argon, gemini_3_8_flash, grok_4_7, mistral_large_4, glm_5_3, glm_5_3_flash, qwen_3_8_max, qwen_3_8_flash) are all in the snapshot (cost: Some(CostConfig)). The OpenAI ones carry a context tier: above 272K prompt tokens the whole request bills at the long-context rates (gpt_5_5's long-band cached-input rate is unverified; see its note in the data file); so do claude_haiku_5_5 (above 100K) and grok_4_7 (above 200K; xAI bills a prompt of exactly 200,000 tokens at the higher rate, see its note). gemini_4_argon, gemini_3_8_flash and mistral_large_4 carry the regular rate while their vendors run a promotion (Gemini 4 Argon through 2026-11-30, 3.8 Flash through 2026-12-31, Mistral's launch sale to about 2026-10-20): until then their costs read up to twice the bill, an upper bound, as with DeepSeek's peak rate. The generic first-party constructors (anthropic, openai, openai_responses, google, xai, groq, deepseek, mistral, zai, minimax, qwen, meta) are priced when the file lists the id — ModelConfig::anthropic("claude-sonnet-5", ..) gets claude_sonnet_5()'s rates, meta prices muse-spark-1.1/-1.2, deepseek prices deepseek-flash/deepseek-v4-pro and the legacy deepseek-v4-flash/deepseek-v4-flash-vision-exp at the peak rate (see DeepSeek Models) — and carry cost: None otherwise. Gateways and custom endpoints (custom, openai_compat, local, ollama, opencode_zen, opencode_go) are always cost: None, since what they bill is not the vendor's list price. None means pricing unknown, not free; set config.cost = Some(CostConfig::new(input, output)) yourself if you want cost reporting. The OpenCode presets select the API protocol from the model id — see OpenCode Zen & Go.

The claude_* presets also set AnthropicCompat::native_structured_output, so Agent::prompt_structured uses the API's native JSON outputs instead of a forced tool call. claude_fable_5_1 and claude_opus_5_5 depend on it, because both models reject forced tool_choice. ModelConfig::anthropic(id, name) infers it (and the thinking mode) from a Claude id, and leaves it off for any other id. See Structured Outputs.

OpenAI-Compatible Presets

These constructors all use OpenAiCompatProvider:

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

let agent = Agent::from_config(ModelConfig::deepseek(
    "deepseek-flash",
    "DeepSeek Flash",
));
}

OpenAI-compatible presets also set OpenAiCompat flags for provider-specific API differences, such as max_tokens vs. max_completion_tokens, reasoning fields, tool result formatting, and streaming usage support. See OpenAI Compatible for the full quirk-flag list.

OpenAI Presets

The OpenAI presets also declare each model's reasoning-effort ceiling (OpenAiCompat::max_reasoning_effort), so ThinkingLevel::XHigh/Max reach the model's real top rung instead of being clamped to high:

ThinkingLevel::Off omits the effort on every preset, so the model runs at its own default (medium on GPT-5.5, Sol and Luna) — it does not turn reasoning off. The crate never sends OpenAI's none rung (GPT-6 Astra, among others, rejects it with a 400).

The GPT-6 presets use the Responses API because Chat Completions does not support function calling with GPT-6 Astra, and allows it on Sol/Luna only at effort none. GPT-6 rejects temperature while the effort is not none, and this crate never sends none — leave temperature unset. The Responses provider does not enforce prompt_structured schemas (it warns and ignores the schema), so structured outputs on the GPT-6 presets are not guaranteed to match. There is no bare gpt-6 model id.

Ollama Models

Use ModelConfig::ollama for Ollama's OpenAI-compatible endpoint:

#![allow(unused)]
fn main() {
let llama = ModelConfig::ollama("http://localhost:11434/v1", "llama3.1:8b");
}

Ollama remains separate from ModelConfig::local(...) because some Ollama-served models need an assistant message after tool results, while other local OpenAI-compatible servers may not. The Ollama preset enables that transcript workaround; the generic local preset stays neutral.

Qwen Models

Use ModelConfig::qwen for hosted Qwen / DashScope:

#![allow(unused)]
fn main() {
let qwen = ModelConfig::qwen("qwen3.6-plus", "Qwen 3.6 Plus");
}

The default base URL is the international DashScope endpoint. For other regions, override base_url after construction:

#![allow(unused)]
fn main() {
let mut qwen = ModelConfig::qwen("qwen3.6-plus", "Qwen 3.6 Plus");
qwen.base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1".into();
}

Region endpoints:

• International/Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
• China/Beijing: https://dashscope.aliyuncs.com/compatible-mode/v1
• US/Virginia: https://dashscope-us.aliyuncs.com/compatible-mode/v1

For locally deployed Qwen, keep the local endpoint and opt into Qwen's model-family compat flags:

#![allow(unused)]
fn main() {
let qwen_local = ModelConfig::openai_compat(
    "http://localhost:1234/v1",
    "qwen3-local",
    "qwen",
    OpenAiCompat::qwen(),
);
}

If a local serving layer also has its own quirks, combine the compat flags explicitly. For example, Qwen served by Ollama may need both Qwen reasoning parsing and Ollama's tool-result transcript workaround:

#![allow(unused)]
fn main() {
let mut compat = OpenAiCompat::qwen();
compat.requires_assistant_after_tool_result = true;

let qwen_ollama = ModelConfig::openai_compat(
    "http://localhost:11434/v1",
    "qwen2.5-coder:7b",
    "ollama",
    compat,
);
}

DeepSeek Models

Use the current DeepSeek API model IDs:

#![allow(unused)]
fn main() {
let flash = ModelConfig::deepseek("deepseek-flash", "DeepSeek Flash"); // V4.1 Flash (1017), takes images
let pro = ModelConfig::deepseek("deepseek-v4-pro", "DeepSeek V4 Pro");
}

Pricing (after prices::enable_bundled()): deepseek-flash and the legacy deepseek-v4-flash / deepseek-v4-flash-vision-exp at $0.30 input / $0.006 cache hit / $1.20 output per million tokens, deepseek-v4-pro at $1.32 / $0.044 / $3.96 — DeepSeek's peak rates. Off-peak (every hour but 01:00–04:00 and 06:00–10:00 UTC on weekdays) DeepSeek bills half; a CostConfig has no time of day, so reported costs are an upper bound and a Budget stops early rather than late. To count off-peak rates, install them as an override (Model Pricing).

The legacy names deepseek-chat and deepseek-reasoner were discontinued on 2026-07-24; requests using them fail. deepseek-v4-flash (and deepseek-v4-flash-vision-exp) are still accepted, but the V4 Flash model behind them is retired — DeepSeek serves those requests with V4.1 Flash at the Flash price. Prefer deepseek-flash. Since the V4.1-Flash-1017 snapshot, deepseek-flash accepts images (deepseek-v4-pro does not); yoagent sends them as OpenAI-style image_url parts, as for every OpenAI-compatible provider.

yoagent also sends DeepSeek's current request shape:

• max_tokens, not max_completion_tokens
• thinking: { "type": "enabled" | "disabled" }
• reasoning_effort when ThinkingLevel is not Off
• DeepSeek cache hit/miss usage fields when present

Both models default to thinking mode. What used to be deepseek-chat is the same model with thinking off:

#![allow(unused)]
fn main() {
let non_thinking = Agent::from_config(ModelConfig::deepseek("deepseek-flash", "DeepSeek Flash"))
    .with_thinking(ThinkingLevel::Off);
}

Compat Flags Without Constructors

OpenAiCompat also has quirk presets such as OpenAiCompat::cerebras() and OpenAiCompat::openrouter(). Those are compatibility profiles, not full ModelConfig constructors. To use them, call ModelConfig::openai_compat(...) with the provider name, base URL, and compat value you need. The API key is resolved from the provider string, so pass "cerebras" / "openrouter" as provider to pick up CEREBRAS_API_KEY / OPENROUTER_API_KEY; any other name falls back to YOAGENT_API_KEY / API_KEY (see API keys).