Langfuse JS/TS SDKs
    Preparing search index...

    Interface PricingTierInput

    Input schema for creating a pricing tier. The tier ID will be automatically generated server-side.

    When creating a model with pricing tiers:

    • Exactly one tier must have isDefault=true (the fallback tier)
    • The default tier must have priority=0 and conditions=[]
    • All tier names and priorities must be unique within the model
    • Each tier must define at least one price

    See PricingTier for detailed information about how tiers work and why they're useful.

    interface PricingTierInput {
        conditions: PricingTierCondition[];
        isDefault: boolean;
        name: string;
        prices: Record<string, number>;
        priority: number;
    }
    Index

    Properties

    conditions: PricingTierCondition[]

    Array of conditions that must ALL be met for this tier to match (AND logic).

    The default tier must have an empty array (conditions=[]). Conditional tiers should define one or more conditions that specify when this tier's pricing applies.

    Each condition specifies a regex pattern, operator, and threshold value for matching against usage details.

    isDefault: boolean

    Whether this is the default tier. Exactly one tier per model must be marked as default.

    Requirements for default tier:

    • Must have isDefault=true
    • Must have priority=0
    • Must have empty conditions array (conditions=[])

    The default tier acts as a fallback when no conditional tiers match.

    name: string

    Name of the pricing tier for display and identification purposes.

    Must be unique within the model. Common patterns: "Standard", "High Volume Tier", "Extended Context"

    prices: Record<string, number>

    Prices (USD) by usage type for this tier. At least one price must be defined.

    Common usage types: "input", "output", "total", "request", "image" Prices are in USD per unit (e.g., per token).

    Example: {"input": 0.000003, "output": 0.000015} represents $3 per million input tokens and $15 per million output tokens.

    priority: number

    Priority for tier matching evaluation. Lower numbers = higher priority (evaluated first).

    Must be unique within the model. The default tier must have priority=0. Conditional tiers should use priority 1, 2, 3, etc. based on their specificity.