# ADR: AI Inference Cost Model

Status: Accepted  
Date: 2026-05-12

## Decision

V2 uses text-first AI commentary and analysis with hard cost caps. Direct
per-frame vision commentary is not part of launch.

## Cost Caps

- Public casual matches: post-match text summary by default; live commentary is
  opt-in and feature-gated.
- Ranked matches: no live LLM call in the deterministic match path.
- Esports broadcast matches: average <= USD 0.003 per commentary minute and hard
  cap <= USD 0.10 per match before failover.
- Highlight reels: queued batch work with per-event budget approval.

## Implementation Contract

When a cap is reached, `@iris/failover` routes to local or preauthored
commentary. Cost counters must be emitted to `@oshun/metrics` and visible in the
esports operations dashboard before public use.
