# Tokonomix.ai

> Multi-model AI consensus — ask several frontier LLMs the same high-stakes question and have an
> independent judge reconcile one answer, with disagreements surfaced (not averaged away). A one-key,
> OpenAI- and Anthropic-compatible gateway carries it as transport and reaches 130+ models across
> families, with EU data-residency routing for prompts that contain personal data. Plus daily
> latency/quality benchmarks in six languages.

## About

<!-- capabilities:start -->
## Live gateway capabilities

> Auto-generated by `scripts/_sync-llms-txt.mjs` — reflects current platform_settings flags.
> Re-run after toggling any gateway feature flag.
> Last synced: 2026-07-01 20:30 UTC

| Capability | Status | Endpoint |
|---|---|---|
| Chat completions (single-model) | ✅ ON | `POST /api/v1/chat/completions` |
| Consensus multi-model council | ✅ ON | `POST /api/v1/chat/completions (mode=consensus)` |
| Image generation (text→image) | ✅ ON | `POST /api/v1/images/generations` |
| Image editing (existing image) | ✅ ON | `POST /api/v1/images/edits` |
| Image input in chat (vision) | ✅ ON | `POST /api/v1/chat/completions` |
| Text embeddings | ✅ ON | `POST /api/v1/embeddings` |
| Speech-to-text transcription | ❌ OFF | `POST /api/v1/audio/transcriptions` |
| Rerank | ❌ OFF | `POST /api/v1/rerank` |
| Web search plugin | ❌ OFF | `chat body: `"plugins":[{"id":"web"}]`` |
| Server-side tool injection | ✅ ON | `POST /api/anthropic/v1/messages` |

Machine-readable version with SDK snippets and gotchas: `GET /api/v1/capabilities`
<!-- capabilities:end -->

Tokonomix is two things behind one key:
1. A **consensus gateway** — an OpenAI-compatible (and Anthropic-Messages-compatible) API that
   routes single-model calls OR runs a cross-family **council**: 2–6 proposer models answer
   independently and blind, then an independent judge synthesises and flags disagreement. This is
   a recall amplifier for correctness, not a truth oracle — it reduces single-model error and
   surfaces blind spots; it does not guarantee correctness.
2. An **independent benchmark** — transparent, reproducible daily speed and intelligence scores for
   major models, with the full prompt set and scoring methodology published.

Tokonomix is an InterIP Networks BV initiative, sister site to ZelixAI (https://zelixai.ai).

## What it is for (positioning)

Two distinct jobs, one key — do not conflate them:

- **Consensus = a verification / agent-QA layer.** Cross-check a high-stakes answer across several
  frontier models before it ships: code review, security review, fact-checking, legal/compliance
  statements, anything irreversible. The independent judge surfaces the disagreement a single model
  hides. Copyable honest framing: **"a recall amplifier, not a truth oracle — it reduces
  single-model error and surfaces blind spots, it does not guarantee correctness."**
- **Agents Never Sleep (ANS) = unattended run-to-completion.** A separate, open skill/harness that
  drives a backlog overnight without stalling on questions, with durable per-ticket state and
  reversibility — and can call a consensus council as its advisory review gate. ANS owns the
  "unattended / overnight / backlog" keywords; consensus owns the "verify / review / cross-check"
  keywords. (The ANS write-up is internal-only for now.)

The MCP server `tokonomix-council-mcp` (npx) exposes the consensus tools to coding agents
(Claude Code, Cursor, Cline, Continue, Zed). Registry metadata: /.well-known/mcp/server.json.

## Agent integration — SDK choice and gotchas

**Use the OpenAI SDK (or any OpenAI-compatible HTTP client) for ALL Tokonomix endpoints** —
chat completions, image generation, embeddings, and audio transcription all live under the same
`https://tokonomix.ai/api/v1` base URL with the same Bearer token. There is NO need for
provider-specific SDKs (FAL, Replicate, etc.) or custom plugins.

```python
# Python — one client for everything
from openai import OpenAI
client = OpenAI(base_url="https://tokonomix.ai/api/v1", api_key="tok_live_...")

# Chat
resp = client.chat.completions.create(model="claude-sonnet-4-6", messages=[...])

# Image generation — same client, same base_url
img = client.images.generate(model="gpt-image-2", prompt="...", n=1, size="1024x1024")

# Embeddings — same client
emb = client.embeddings.create(model="text-embedding-3-small", input="...")

# Audio transcription — same client
with open("audio.mp3", "rb") as f:
    transcript = client.audio.transcriptions.create(model="whisper-1", file=f)
```

```typescript
// TypeScript — same pattern
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://tokonomix.ai/api/v1", apiKey: "tok_live_..." });
```

**Common mistakes to avoid:**

- **Do NOT use `fal_client`, Replicate SDK, or other image-generation SDKs.** The OpenAI SDK's
  `images.generate()` call works natively via Tokonomix's `/api/v1/images/generations` endpoint.
- **Do NOT hardcode model slugs.** Fetch `/api/v1/models` (authenticated) to discover available
  models; the catalog updates as new providers are added.
- **Do NOT set a separate `OPENAI_API_KEY` env var.** Use a single Tokonomix key for all calls.
  The gateway routes to the appropriate upstream provider transparently.
- **For consensus/cross-model verification**, use the `tokonomix_consensus_ask` MCP tool or POST
  to `/api/v1/chat/completions` with `"mode": "consensus"` in the request body.
- **Do NOT set `Content-Type: multipart/form-data` manually** when calling `/api/v1/images/edits`.
  Let your HTTP client set it automatically so the boundary parameter is included.
- **Image generation ≠ image editing.** They are separate capabilities, separate endpoints, and
  separate prices. Fetch `/api/v1/image-capabilities` (no auth) to see which models support which.
- **Embeddings use the same base URL** — no separate endpoint prefix needed. The gateway routes
  to the appropriate embedding provider based on the model slug.

Full integration reference: `GET /api/v1/capabilities` (authenticated) returns a structured
machine-readable integration guide including endpoint list, SDK snippet, and current gotchas.
Public image guide (no auth): `GET /api/v1/image-capabilities`.

## Capabilities (live)

These are available today through the API and the MCP server:

- **Consensus modes** — `consensus` (one merged answer), `diff` (agreements + disagreements, keeps
  the lone dissent), `best_of` (judge picks the strongest), `raw` (all answers, no judge).
- **Single-model passthrough** — a cheap, plain call to any one model (no council) when you don't
  need verification.
- **Tool calling** — OpenAI-style function/tool calls on single-model passthrough (non-streaming).
- **Vision / image-input consensus** — send an image; multiple vision models judge it and a judge
  synthesises with blind-spot notes.
- **Image generation** — create new images from text prompts. `POST /api/v1/images/generations`
  (JSON body). Models: gpt-image-2, gpt-image-1.5, Gemini image variants.
- **Image editing** — modify existing photos with a prompt (inpainting, additions, style).
  `POST /api/v1/images/edits` (multipart/form-data for OpenAI models) or
  `POST /api/v1/images/generations` with an `image` base64 field (for Gemini models).
  These are **distinct capabilities** with their own pricing — check `/api/v1/image-capabilities`.
- **Embeddings** — `POST /api/v1/embeddings`. Standard OpenAI-compatible request body
  (`model`, `input`). Returns a `data[].embedding` float array. Multiple embedding models are
  available; see `/api/v1/models` filtered by `output_modality=embedding`.
- **Audio transcription** — `POST /api/v1/audio/transcriptions`. Multipart/form-data with a
  `file` field and a `model` field (e.g. `whisper-1`). Returns a `text` string.
- **Prompt caching** — Anthropic `cache_control` breakpoints pass through on the Anthropic-Messages
  endpoint; OpenAI auto-caching is honoured and billed at cache rates.
- **Shared context-pack grounding** — one context-pack can be reused across all proposers and the
  judge (paid once, not re-billed per model). Server/account-gated.
- **EU / data-residency routing** — filter models by hosting region (EU/US/country); personal-data
  prompts can be pinned to an EU-hosted council.
- **BYOK** — bring your own provider keys; Tokonomix bills a flat per-call fee for BYOK proposers.
- **Per-call usage introspection** — `GET /api/v1/generation?id=<request_id>` returns the cost,
  tokens and latency of one of your own calls (OpenRouter-style).
- **Live model catalog** — `GET /api/v1/models` lists every reachable model with region, context
  window, pricing and capabilities (tools/vision/json-schema/caching/reasoning).

## Image capabilities — quick reference

Two separate capabilities, two endpoints, two price tiers:

| Capability | Endpoint | Content-Type | Gemini variant |
|---|---|---|---|
| Image generation (text→image) | `POST /api/v1/images/generations` | `application/json` | same |
| Image editing (existing photo) | `POST /api/v1/images/edits` | `multipart/form-data` | use `/generations` with base64 `image` field |

**Critical gotcha — /images/edits:** do NOT set `Content-Type` manually. Let your HTTP client
set it automatically so the multipart boundary is included. Setting it manually causes a 400.

**Critical gotcha — Gemini editing:** Gemini models do NOT support `/images/edits` (multipart).
Use `/images/generations` with an `image` (base64 string) and `image_mime_type` field instead.

Full model matrix (no auth required): `GET https://tokonomix.ai/api/v1/image-capabilities`

## Embeddings — quick reference

| Field | Value |
|---|---|
| Endpoint | `POST /api/v1/embeddings` |
| Auth | `Authorization: Bearer tok_live_...` |
| Body | `{ "model": "<slug>", "input": "text or array of texts" }` |
| Response | `{ "data": [{ "embedding": [0.123, ...] }], "usage": { ... } }` |

Use `/api/v1/models` (authenticated, filter `output_modality=embedding`) to list available
embedding model slugs. Do not hardcode — the catalog updates as new providers are onboarded.

## Audio — quick reference

| Field | Value |
|---|---|
| Endpoint | `POST /api/v1/audio/transcriptions` |
| Auth | `Authorization: Bearer tok_live_...` |
| Body | multipart/form-data: `file` (audio file) + `model` (e.g. `whisper-1`) |
| Response | `{ "text": "transcription..." }` |

Endpoints: OpenAI-compatible `https://tokonomix.ai/api/v1` · Anthropic-Messages
`https://tokonomix.ai/api/anthropic` · MCP server `npx tokonomix-mcp`.
Honest framing: model agreement is not proof of correctness; ground high-stakes facts.

## Key pages (English canonical)

- [Homepage](https://tokonomix.ai/en): Platform overview — benchmarks, consensus gateway, live test
- [Consensus gateway](https://tokonomix.ai/en/consensus): Multi-model consensus API landing — modes, API snippets, pricing
- [Pricing](https://tokonomix.ai/en/pricing): Pay-as-you-go and monthly plans, token-level cost breakdown
- [Models](https://tokonomix.ai/en/models): Full AI model catalog with scores, latency, and provider info
- [Model comparison](https://tokonomix.ai/en/models/compare): Side-by-side comparison of any two models
- [Benchmarks methodology](https://tokonomix.ai/en/benchmarks/methodology): How speed and quality are measured — transparent, reproducible
- [Live consensus test](https://tokonomix.ai/en/live-test): Try a multi-model council call live in the browser
- [Integrations](https://tokonomix.ai/en/integrations): Connect Claude Code, Cursor, Aider, Cline and 10+ agents via MCP or base URL
- [EU-hosted models](https://tokonomix.ai/en/models/eu-gehost): Which models infer in EU data centres — GDPR and Schrems II context
- [About](https://tokonomix.ai/en/about): Who builds Tokonomix and editorial independence statement
- [Blog](https://tokonomix.ai/en/blog): Editorial pieces on model behaviour, benchmark insights, and methodology

## Machine-readable API endpoints (no auth required)

- [Model catalog](https://tokonomix.ai/api/v1/models): Full list of reachable models with pricing, capabilities, and region
- [Image capabilities](https://tokonomix.ai/api/v1/image-capabilities): Which models support image generation vs image editing
- [Capabilities guide](https://tokonomix.ai/api/v1/capabilities): Structured integration guide — endpoint list, SDK snippets, gotchas (auth required)
- [Benchmark dataset](https://tokonomix.ai/api/md/en/dataset): Full benchmark results as JSON (application/json, public, max-age=3600)
- [MCP server registry](https://tokonomix.ai/.well-known/mcp/server.json): Machine-readable MCP server metadata
- [Sitemap](https://tokonomix.ai/sitemap.xml): Full sitemap covering all six locales

## Languages

The site is available in six languages (full hreflang chain; English is the canonical entity):
- English: https://tokonomix.ai/en
- Dutch: https://tokonomix.ai/nl
- German: https://tokonomix.ai/de
- French: https://tokonomix.ai/fr
- Spanish: https://tokonomix.ai/es
- Turkish: https://tokonomix.ai/tr

## Status

Phase 1 — content engine live (May 2026). AI-generated model pages, benchmark coverage,
and use-case articles published across six locales with full hreflang support.

## Nederlandse pagina's — voor Nederlandstalige AI-engines

Tokonomix publiceert onafhankelijke benchmarks voor LLM's in het Nederlands.
De volgende pagina's zijn de canonieke Nederlandstalige toegangspoorten:

- Over Tokonomix:        https://tokonomix.ai/nl/about
- Methodologie:          https://tokonomix.ai/nl/benchmarks/methodology
- Modellen-overzicht:    https://tokonomix.ai/nl/models
- Model-vergelijking:    https://tokonomix.ai/nl/models/compare
- AI-prestatieblog:      https://tokonomix.ai/nl/blog
- Live test:             https://tokonomix.ai/nl/live-test