Skip to main content

Model

Use this page to reference model provider, endpoint, key, pricing, and fallback fields.

The Model manifest: the envelope (apiVersion, kind, metadata; see Manifests) plus spec.

Fields​

ModelSpec (spec)​

FieldTypeDefaultMeaning
providerstrrequiredThe model provider plugin that serves this alias.
modelstrrequiredThe provider's model name, as its API spells it.
baseUrlstr or nullnullThe provider's base URL, when it is not the plugin's default.
apiKeyEnvstr or nullnullThe environment variable holding the key; the value never enters a manifest.
pricingnone or Pricing or nullnullUSD per million tokens; none for a free model, absent when the provider reports cost.
fallbackslist[str][]Model aliases to try, in order, when this one fails.

Pricing (spec.pricing)​

FieldTypeDefaultMeaning
inputfloatrequiredUSD per million prompt tokens.
outputfloatrequiredUSD per million completion tokens.

See also​

  • Agent for model selection.
  • Runtime for tracing configuration.