API & MCP reference

AI models & token usage

The Deputy and the Posse call your chosen AI provider with YOUR key — you pay that provider directly, no SubnetSlinger subscription and no markup. Pick your provider in the Deputy: Anthropic (Claude), OpenAI-compatible (ChatGPT, Groq, OpenRouter, Azure OpenAI, LM Studio/vLLM), Google Gemini, or Ollama for a free local model (no cloud, no cost — see "Ollama — run the AI locally"). The app estimates the $ cost for common Anthropic, OpenAI, and Gemini models; an unknown or custom model shows token counts without a $ estimate (check your provider's rates). Cost depends on HOW you use it, lowest to highest: Ollama (free, local) < Haiku 4.5 / GPT-4o-mini / Gemini Flash < Sonnet 4.6 / GPT-4o / Gemini 2.5 Pro < Opus 4.8 < a Posse sweep (highest per run; free on Ollama).

The three models (cheapest → most capable):

  • Haiku 4.5 — fastest & cheapest. The DEFAULT. Great for quick lookups and most routine questions.
  • Sonnet 4.6 — balanced speed/depth. Good for multi-step investigations.
  • Opus 4.8 — deepest reasoning, priciest. Save it for genuinely hard problems.

Pick per chat in the Deputy's model dropdown; it opens on Haiku so you only pay for Opus when you choose it.

How you're billed: per TOKEN, split into input (everything sent — your question + tool results + history) and output (the model's reply). Rough list price, US$ per 1,000,000 tokens — estimates at current pricing (Sept 2026); rates change, so check your provider:

Haiku 4.5 ~ $1 in / $5 out

Sonnet 4.6 ~ $3 in / $15 out

Opus 4.8 ~ $5 in / $25 out

A typical short question is a few thousand tokens — fractions of a cent on Haiku.

The live meter: above the Deputy's composer (and on the Posse screen) an always-on strip shows a Tools on/off pill, 'today ~$X · this chat ~$Y · in N · out N', and 'Ctx N%' (how full the model's context window is) — the same readout the mobile app shows, updating live as the model works, not just at the end. Ollama shows 'local (free)'. The Tools pill is a real switch: OFF sends a plain chat with no tools (cheaper, one round-trip — good for interpreting pasted output); ON lets the Deputy run diagnostics.

Spend caps (three): in AI settings set 'Cap per day' (default $10, ON — a global ceiling across every chat AND the Posse, from a running total that resets at midnight and survives restarts), 'Cap per Posse run' (default $2, ON — bounds one sweep, the priciest action; refuses a launch over the estimate and aborts a sweep that crosses it), and 'Cap this chat' (optional, 0 = off — resets on New chat). All three abort in-flight — on the next turn/round once cost crosses the cap, so a turn already streaming finishes first (bounded to about one turn), not only the next question. A custom model with no published rate is still capped, priced at a safe upper-bound rate so it can't slip past. The STOP button cancels the current request immediately — the emergency brake. Set any cap to 0 to disable it.

Strongest protection — cap the key at your provider: the caps above are enforced by SubnetSlinger. The ceiling nothing can exceed is a hard spend limit on the API key's OWN billing account — set it once and a runaway anywhere (this app, a script, any tool using that key) still can't spend past it. Anthropic: console.anthropic.com → Settings → Limits. OpenAI: platform.openai.com → Settings → Limits (Usage limits). Google: set a budget/quota on the Cloud billing project. Do this first if you're worried about cost; Ollama is local and free, so it needs no cap.

The Posse and your model: the Posse uses the SAME provider and model you set for the Deputy — change it in the Deputy and the Posse follows. On Anthropic it splits into cheaper specialists (Sonnet) + a deep coordinator (Opus); on OpenAI, Gemini, or Ollama every agent uses that backend's one configured model. A sweep is ~6 model passes, so it costs more than one Deputy question (but $0 on Ollama — just heavier on your machine). Run it when you want the thorough pass.

Keeping cost down: SubnetSlinger auto-trims old tool-result payloads from a long conversation (~30k-token cap) so the input doesn't balloon turn after turn; start a New chat to drop context entirely; and stay on Haiku until a problem actually needs Sonnet/Opus. Tool runs themselves (ping, SNMP, etc.) are local and free — you only pay for the model's reasoning over them.

Staying current: the model list and the price table refresh automatically from a hosted manifest (subnetslinger.com/models.json), so new provider models and rate changes appear WITHOUT an app update.

How it works
INPUT
your question + tool results + prior turns
model
OUTPUT
the reply + recommended fixes
per 1M tokens — in / out
Haiku ~$1 / $5 — default, cheapest
Sonnet ~$3 / $15 — balanced
Opus ~$5 / $25 — deepest
live readout
tokens · in N · out N · ~$X this chat
This page mirrors the in-app help. Open the same article any time from the app's Docs panel. Spot something unclear? Tell us.