Built-in model catalog

Reyn ships a built-in catalog of common model configurations pre-loaded into the model namespace. These entries let you reference well-known models by a short class name without declaring them in reyn.yaml.

These are examples, not endorsements. The built-in catalog provides a convenient starting point. Your reyn.yaml is always the source of truth. Override any entry by declaring the same name under models:.

Catalog entries

claude-sonnet

model: anthropic/claude-3-7-sonnet
max_completion_tokens: 8192

General-purpose Claude Sonnet. Good for most instruction-following tasks.

claude-sonnet-thinking

model: anthropic/claude-3-7-sonnet
max_completion_tokens: 16000
extra_body:
  thinking:
    type: enabled
    budget_tokens: 8000

Claude Sonnet with extended thinking enabled (budget_tokens: 8000). Use this for reasoning-heavy tasks. Cost is roughly 2–3× claude-sonnet for the same output length.

To create a cost variant, use extends:

models:
  reasoning-light:
    extends: claude-sonnet-thinking
    extra_body:
      thinking:
        budget_tokens: 4000   # overrides 8000; type: enabled is carried from base

claude-haiku

model: anthropic/claude-3-5-haiku
max_completion_tokens: 4096

Fast and cost-efficient Claude Haiku. Best for simple extraction and classification tasks.

gpt-4o-mini

model: openai/gpt-4o-mini

OpenAI GPT-4o mini. Low cost, high speed.

gpt-4o

model: openai/gpt-4o

OpenAI GPT-4o. Strong general-purpose model.

gemini-flash-lite

model: openai/gemini-2.5-flash-lite

Google Gemini 2.5 Flash Lite via the OpenAI-compatible shim. Very low cost.

gemini-3.1-flash-preview

model: openai/gemini-3.1-flash-preview

Google Gemini 3.1 Flash Preview via the OpenAI-compatible shim.

gemini-2.0-flash

model: openai/gemini-2.0-flash
extra_body:
  thinking_config:
    thinking_budget: 0

Google Gemini 2.0 Flash with thinking disabled (thinking_budget: 0) for cost reduction.

LiteLLM / Gemini API note: the thinking_config.thinking_budget parameter disables Gemini's thinking mode via LiteLLM's OpenAI-compatible shim. If Gemini or LiteLLM changes this parameter name in a future release, update your reyn.yaml override and check the LiteLLM release notes. This syntax is not guaranteed stable across provider API versions.

Vendor-specific quirks

max_completion_tokens vs max_tokens

The built-in catalog uses max_completion_tokens for Anthropic models, not max_tokens.

• max_completion_tokens: enforced at the API level by OpenAI o1+ and Anthropic. The provider refuses to generate more tokens than the limit, which makes it effective for hard cost control.
• max_tokens: a legacy soft hint. Many providers ignore it; it has no enforcement power on OpenAI o1+ or Anthropic models.

Always prefer max_completion_tokens when you need a hard output cap.

Anthropic thinking models

claude-sonnet-thinking sends extra_body.thinking.{type, budget_tokens} to the Anthropic API via LiteLLM. The budget_tokens value is the upper bound of reasoning tokens; actual usage may be less. Setting budget_tokens too low can degrade answer quality on complex tasks.

Namespace and override semantics

The built-in catalog is merged into the model namespace before user entries, so user-declared entries always win:

# reyn.yaml
models:
  # Override built-in claude-sonnet with a project-specific variant.
  claude-sonnet:
    model: anthropic/claude-3-7-sonnet
    max_completion_tokens: 4096   # tighter budget for this project

See also

• reference/config/reyn-yaml.md — models: block, extends syntax, deep merge