Ai Provider

This page is auto-generated from the formations OpenAPI spec. Do not edit manually — run pnpm generate-formations-resource-docs to regenerate.

Configures an LLM provider connection (API key, model, endpoint) that agents use to generate responses.

Syntax

type: ai_provider
properties:
  name: String
  provider: String
  default_model: String
  secret_id: String
  base_url: String
  config: Object

Output

The physical resource ID is the public ID of the created resource. Reference it from other resources with a ref expression:

      some_field:
        ref: MyAiProvider

Properties

name

Provider display name

Required: Yes Type: String

---

provider

Provider type (e.g. openai, anthropic)

Required: Yes Type: String

---

default_model

Default model identifier (e.g. gpt-4o, claude-3-7-sonnet)

Required: Yes Type: String

---

secret_id

Public ID of the secret containing the API key

Required: No Type: String Nullable: Yes

---

base_url

Custom base URL for the provider API (self-hosted or proxy)

Required: No Type: String Nullable: Yes

---

config

Provider-specific extra configuration

Required: No Type: Object Nullable: Yes

---