Kostenbewusste LLM-Pipeline

Was macht Kostenbewusste LLM-Pipeline?

Muster zur Kontrolle der LLM-API-Kosten bei gleichzeitiger Aufrechterhaltung der Qualität. Kombiniert Modell-Routing, Budgetverfolgung, Wiederholungslogik und Prompt-Caching in einer komponierbaren Pipeline.

Wann zu aktivieren

• Anwendungen erstellen, die LLM-APIs aufrufen (Claude, GPT usw.)
• Stapel von Elementen mit unterschiedlicher Komplexität verarbeiten
• Ein Budget für API-Ausgaben einhalten müssen
• Kosten optimieren, ohne bei komplexen Aufgaben an Qualität einzubüßen

Kernkonzepte

1. Modell-Routing nach Aufgabenkomplexität

Wählen Sie automatisch günstigere Modelle für einfache Aufgaben aus und reservieren Sie teure Modelle für komplexe.

MODEL_SONNET = "claude-sonnet-5"
MODEL_HAIKU = "claude-haiku-4-5-20251001"

_SONNET_TEXT_THRESHOLD = 10_000  # Zeichen
_SONNET_ITEM_THRESHOLD = 30     # Elemente

def select_model(
    text_length: int,
    item_count: int,
    force_model: str | None = None,
) -> str:
    """Modell basierend auf Aufgabenkomplexität auswählen."""
    if force_model is not None:
        return force_model
    if text_length >= _SONNET_TEXT_THRESHOLD or item_count >= _SONNET_ITEM_THRESHOLD:
        return MODEL_SONNET  # Komplexe Aufgabe
    return MODEL_HAIKU  # Einfache Aufgabe (3-4x günstiger)

2. Unveränderliche Kostenverfolgung

Verfolgen Sie die kumulierten Ausgaben mit frozen Dataclasses. Jeder API-Aufruf gibt einen neuen Tracker zurück – der Zustand wird nie verändert.

from dataclasses import dataclass

@dataclass(frozen=True, slots=True)
class CostRecord:
    model: str
    input_tokens: int
    output_tokens: int
    cost_usd: float

@dataclass(frozen=True, slots=True)
class CostTracker:
    budget_limit: float = 1.00
    records: tuple[CostRecord, ...] = ()

    def add(self, record: CostRecord) -> "CostTracker":
        """Gibt neuen Tracker mit hinzugefügtem Datensatz zurück (ändert self nie)."""
        return CostTracker(
            budget_limit=self.budget_limit,
            records=(*self.records, record),
        )

    @property
    def total_cost(self) -> float:
        return sum(r.cost_usd for r in self.records)

    @property
    def over_budget(self) -> bool:
        return self.total_cost > self.budget_limit

3. Enge Wiederholungslogik

Wiederholung nur bei vorübergehenden Fehlern. Schnell fehlschlagen bei Authentifizierungs- oder Fehlern bei fehlerhaften Anfragen.

from anthropic import (
    APIConnectionError,
    InternalServerError,
    RateLimitError,
)

_RETRYABLE_ERRORS = (APIConnectionError, RateLimitError, InternalServerError)
_MAX_RETRIES = 3

def call_with_retry(func, *, max_retries: int = _MAX_RETRIES):
    """Nur bei vorübergehenden Fehlern wiederholen, bei anderen sofort fehlschlagen."""
    for attempt in range(max_retries):
        try:
            return func()
        except _RETRYABLE_ERRORS:
            if attempt == max_retries - 1:
                raise
            time.sleep(2 ** attempt)  # Exponentielles Backoff
    # AuthenticationError, BadRequestError usw. → sofort auslösen

4. Prompt-Caching

Zwischenspeichern langer System-Prompts, um sie nicht bei jeder Anfrage erneut senden zu müssen.

messages = [
    {
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": system_prompt,
                "cache_control": {"type": "ephemeral"},  # Dies zwischenspeichern
            },
            {
                "type": "text",
                "text": user_input,  # Variabler Teil
            },
        ],
    }
]

Zusammensetzung

Kombinieren Sie alle vier Techniken in einer einzigen Pipeline-Funktion:

def process(text: str, config: Config, tracker: CostTracker) -> tuple[Result, CostTracker]:
    # 1. Modell routen
    model = select_model(len(text), estimated_items, config.force_model)

    # 2. Budget prüfen
    if tracker.over_budget:
        raise BudgetExceededError(tracker.total_cost, tracker.budget_limit)

    # 3. Aufruf mit Wiederholung + Caching
    response = call_with_retry(lambda: client.messages.create(
        model=model,
        messages=build_cached_messages(system_prompt, text),
    ))

    # 4. Kosten verfolgen (unveränderlich)
    record = CostRecord(model=model, input_tokens=..., output_tokens=..., cost_usd=...)
    tracker = tracker.add(record)

    return parse_result(response), tracker

Preisreferenz (2026)

Modell	Eingabe ($/1M Tokens)	Ausgabe ($/1M Tokens)	Relativer Preis
Haiku 3.5 (Legacy)	$0.80	$4.00	0.8x
Haiku 4.5	$1.00	$5.00	1x
Sonnet 5	$2.00	$10.00	2x
Sonnet 4.6	$3.00	$15.00	3x
Opus 4.8	$5.00	$25.00	5x
Fable 5 / Mythos 5	$10.00	$50.00	10x
Opus 4.0 / 4.1 (Legacy)	$15.00	$75.00	15x

Best Practices

• Beginnen Sie mit dem günstigsten Modell und routen Sie nur zu teuren Modellen, wenn die Komplexitätsschwellwerte erreicht sind
• Legen Sie explizite Budgetlimits fest, bevor Sie Stapel verarbeiten – früh scheitern, anstatt das Budget zu überschreiten
• Protokollieren Sie Modellauswahlentscheidungen, um Schwellwerte basierend auf echten Daten anpassen zu können
• Verwenden Sie Prompt-Caching für System-Prompts über 1024 Tokens – spart sowohl Kosten als auch Latenz
• Wiederholen Sie niemals bei Authentifizierungs- oder Validierungsfehlern – nur bei vorübergehenden Fehlern (Netzwerk, Ratenbegrenzung, Serverfehler)

Anti-Patterns, die vermieden werden sollten

• Das teuerste Modell für alle Anfragen unabhängig von der Komplexität verwenden
• Bei allen Fehlern wiederholen (verschwendet Budget bei dauerhaften Fehlern)
• Den Kostenverfolgungsstatus verändern (macht Debugging und Audits schwierig)
• Modellnamen hart im Code zu kodieren (Konstanten oder Konfiguration verwenden)
• Prompt-Caching für sich wiederholende System-Prompts ignorieren

Wann zu verwenden

• Jede Anwendung, die Claude, OpenAI oder ähnliche LLM-APIs aufruft
• Batch-Verarbeitungspipelines, bei denen die Kosten schnell steigen
• Multi-Modell-Architekturen, die ein intelligentes Routing benötigen
• Produktionssysteme, die Budget-Absicherungen benötigen