terraform-provider-stackgen

sg_guild_model (Resource)

⚠️ Experimental — This resource is part of the Guild platform and may change in future releases.

Manages a named LLM model configuration linked to a registered provider. Models define the specific model identifier, thinking routing, and optional tuning parameters. Agents reference models by name.

Example Usage

# Model registered under a provider (create sg_guild_model_provider first).
resource "sg_guild_model_provider" "openai" {
  name          = "openai-shared"
  provider_type = "openai"
  scope         = "TENANT"
}

resource "sg_guild_model" "example" {
  name          = "gpt-4o-default"
  model_id      = "gpt-4o"
  provider_name = sg_guild_model_provider.openai.name
  # Optional: TENANT, PROJECT, or USER — matches Guild IntegrationScope.
  scope = "TENANT"
}

Import

Import an existing sg_guild_model using its model name:

terraform import sg_guild_model.example 'gpt-4o-toolcalling'

Schema

Required

• model_id (String) Provider-specific model identifier (e.g. gpt-4o or claude-sonnet-4-6).
• name (String) Unique model name (e.g. gpt-4o-toolcalling or openai-gpt-5.4-mini). Changing forces replacement.
• provider_name (String) Name of the registered model provider this model belongs to.

Optional

• good_for_task (String) Deprecated legacy task affinity. No longer accepted by Guild; remove this field and explicitly choose thinking (true for Think routing or false for NoThink routing).
• reasoning_effort (String) Vendor-specific reasoning effort. Allowed values: auto none minimal low medium high xhigh max. Guild validates support against the model catalog; auto delegates to the provider.
• scope (String) Integration scope for this model: TENANT PROJECT or USER. When unset on create the Guild API default applies.
• thinking (Boolean) Route Think/plan/synthesis work to this model when true; false routes NoThink/dig/classify work. Guild defaults to false on create.

Read-Only

• pricing_input_usd (Number) Input-side price from the registered model when returned by the API.
• pricing_output_usd (Number) Output-side price from the registered model when returned by the API.
• pricing_total_usd (Number) Total price hint from the registered model when returned by the API.