v0.16.6

m-bain/whisperXv0.16.6Oct 20, 2026by tashfeenahmed

Upgrading?

AI Summary

This release eliminates repeated empty-search key checks for SerpSearch, Exa and Parallel keys, which had caused account issues. It adds ZCode agent support, a /v1/usage endpoint, and clearer per-key health visibility in the dashboard.

Key Highlights

  • SerpSearch, Exa and Parallel keys are checked once on add instead of every ~5 minutes
  • ZCode provider registry setup via npx freellmapi setup-zcode
  • New GET /v1/usage endpoint for month-to-date requests and tokens by provider
  • Keys now show a "last worked" time distinct from last checked
  • HEALTH_CHECK_INTERVAL_MS environment variable for tuning health checks

Breaking Changes

  • Health-check behavior changed: search-based keys are no longer polled periodically and error-state keys are re-checked at most once per hour

New Features

  • ZCode integration for Desktop and CLI with Agents page visibility
  • "Last worked" timestamp on each key in the dashboard
  • GET /v1/usage endpoint with per-provider breakdown and reset window
  • HEALTH_CHECK_INTERVAL_MS configuration (default 5 minutes, minimum 60 seconds)
  • Analytics fix for repeated URL filter parameters
  • Fusion panel ordering now matches actual decision-strategy routing

Full Release Notes

SerpSearch, Exa and Parallel keys are no longer re-checked with empty searches every few minutes. This release also adds ZCode support, a `/v1/usage` endpoint and a "last worked" time on each key.

## Providers

- **No more empty-search key checks.** SerpSearch, Exa and Parallel (with a real key) have no account endpoint, so their key check is a search with no query. The health checker used to send it every ~5 minutes for every key, and SerpSearch revoked a user's free account over it. These keys are now checked once, when added. A key in an error state is re-checked at most once an hour, and "Check now" / "Check all" still work (#1608, fixes #1599).

## Agents

- **ZCode.** `npx freellmapi setup-zcode --url … --api-key …` adds FreeLLMAPI to ZCode's provider registry (`~/.zcode/v2/provider_config.json`, shared by ZCode Desktop and CLI) and keeps your other providers. ZCode requests show up on the Agents page. CLI 0.8.2 (#1607, #1523).

## Dashboard

- **"Last worked" on each key.** Hovering a key's last-checked time now also shows when it last served a request or passed a check, so "checked recently" and "actually working" are no longer the same thing (#1606, #1493).
- **Analytics fix.** A filter repeated in the URL (`?provider=a&provider=b`) no longer breaks the recent-calls panel with a 500 (#1597).
- **Fusion panel order** now matches how requests actually route under the decision strategy (#1604).

## API

- **`GET /v1/usage`.** Month-to-date requests and tokens, split by provider, plus when the window resets. Read from the same ledger as the monthly caps. Unified key only; client-profile keys get 403 (#1600).
- **`HEALTH_CHECK_INTERVAL_MS`.** Sets how often keys are health-checked (default 5 minutes, minimum 60 seconds) (#1605, #1593).

## Updating

Desktop installers below cover Windows, Apple Silicon and Intel macOS, and Linux. Docker: `ghcr.io/tashfeenahmed/freellmapi:v0.16.6` (`latest` also points here). Existing keys and profiles are retained. One additive migration (`api_keys.last_healthy_at`) runs automatically on start.

Full changelog: https://github.com/tashfeenahmed/freellmapi/compare/v0.16.5...v0.16.6

---
⭐ Like the free router? [Go Premium](https://freellmapi.co/?utm_source=github&utm_medium=release&utm_campaign=premium&utm_content=v0.16.6#pricing) — the live signed catalog, $19/yr, cancel anytime.

Related Repositories