Function●Since v0.0

create_model

Create a chat model.

Uses init_chat_model for standard providers, or imports a custom BaseChatModel subclass when the provider has a class_path in config.

Supports provider:model format (e.g., 'anthropic:claude-sonnet-4-5') for explicit provider selection, or bare model names for auto-detection.

create_model(
  model_spec: str | None = None,
  *,
  extra_kwargs: dict[str, Any] | None = None
) -> ModelResult

Parameters

Name	Type	Description
`model_spec`	`str \| None`	Default:`None` Model specification in `provider:model` format (e.g., `'anthropic:claude-sonnet-4-5'`, `'openai:gpt-4o'`) or just the model name for auto-detection (e.g., `'claude-sonnet-4-5'`). `If not provided, uses environment-based defaults.`
`extra_kwargs`	`dict[str, Any] \| None`	Default:`None` Additional kwargs to pass to the model constructor. These take highest priority, overriding values from the config file.