create_model

create_model(
  model_spec: str | None = None,
  *,
  extra_kwargs: dict[str

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-5.5'`) 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.
`profile_overrides`	`dict[str, Any] \| None`	Default:`None`

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., 'openai:gpt-5.5') for explicit provider selection, or bare model names for auto-detection.

Extra profile fields from --profile-override.

Merged on top of config file profile overrides (dcode wins).