Models Nomenclature
Model identifiers follow a structured format to ensure clarity and flexibility when working across different providers and configurations.
Format
client:model::version
client→ The model provider (e.g.,openai,deepseek,grok,gemini,anthropic,ollama,fireworks)model→ The exact model name as defined by the providerversion→ A user-defined label to distinguish between configurations (e.g.,v1,default,projectX)
modelandversionare only required whenazLLMis instantiated with custom configurations.
Colon Rules
Use a single colon (
:) to separateclientandmodelUse double colons (
::) to separatemodelandversion
Examples
openai:gpt-4.1-2025-04-14::defaultdeepseek:deepseek-chat::v2fireworks:accounts/fireworks/models/llama4-scout-instruct-basic::project1
Notes
For default configurations, simply provide the
clientname (e.g.,openai). A default model and version will be applied automatically.For custom configurations, always use the full
client:model::versionformat.