# KeepBal

> KeepBal is Digidai’s agent capability layer: one dgk_live_ key for OpenAI-compatible models and priced tools, settled in a wallet you can audit. KeepRouter is a sister product, not this API.

Canonical URL: https://keepbal.com
Current upstream mode: monid_validation

Hard lock: upstream modes `aisa_validation` and `monid_validation` are temporary validation adapters only. They are not the permanent backend and not a white-label. Direct adapters fail closed (HTTP 503, not billed) when a capability is not configured.

## When to use KeepBal

- You want Digidai-owned identity, keys, wallet, and usage — not a white-label of another gateway.
- You need OpenAI-compatible `/v1` plus `/apis/v1` tools behind `Authorization: Bearer dgk_live_...`.

## When not to

- You need a live MCP/A2A transport, x402 payments, or self-service card top-ups today. Those are not available.
- You need a guarantee that every catalog model is available. Catalogs are candidates, not SLAs.

## Start

1. Open https://keepbal.com/sign-up
2. Create a key at https://keepbal.com/console/keys
3. `GET https://keepbal.com/healthz` then `GET https://keepbal.com/v1/models` with your key

## Machine-readable

- Agent Card: https://keepbal.com/.well-known/agent-card.json
- MCP discovery stub (HTTP tools; no MCP transport yet): https://keepbal.com/.well-known/mcp.json
- OpenAPI 3.1: https://keepbal.com/openapi.yaml
- Catalog JSON: https://keepbal.com/catalog.json
- Skill: https://keepbal.com/SKILL.md
- This file: https://keepbal.com/llms.txt
- Expanded docs: https://keepbal.com/llms-full.txt
- Docs index: https://keepbal.com/docs
- Pricing: https://keepbal.com/pricing
- Quickstart: https://keepbal.com/quickstart
- FAQ: https://keepbal.com/faq
- Compare: https://keepbal.com/compare
- Why KeepBal: https://keepbal.com/compare/why-keepbal
- Health: https://keepbal.com/healthz
- Contact: mailto:hello@keepbal.com
- Security: mailto:security@keepbal.com

## Models

OpenAI-compatible base: https://keepbal.com/v1

- `gpt-5.4` (openai, chat/completions) — input 3000000 / output 12000000 micro-USD per 1M tokens
- `gpt-5.4-mini` (openai, chat/completions) — input 600000 / output 2400000 micro-USD per 1M tokens
- `claude-sonnet-4.5` (anthropic, chat/completions) — input 3600000 / output 18000000 micro-USD per 1M tokens
- `claude-haiku-4.5` (anthropic, chat/completions) — input 1200000 / output 6000000 micro-USD per 1M tokens
- `gemini-2.5-pro` (google, chat/completions) — input 1500000 / output 12000000 micro-USD per 1M tokens
- `gemini-2.5-flash` (google, chat/completions) — input 360000 / output 3000000 micro-USD per 1M tokens
- `deepseek-v3.2` (deepseek, chat/completions) — input 336000 / output 504000 micro-USD per 1M tokens
- `qwen3-max` (alibaba, chat/completions) — input 1440000 / output 7200000 micro-USD per 1M tokens
- `jina-embeddings-v3` (jina, embeddings) — input 60000 / output 0 micro-USD per 1M tokens

Unknown ids may be forwarded in `aisa_validation` and are billed at input 2400000 / output 9600000 micro-USD per 1M tokens. `direct` model routes currently return 503.

## Tools

- `POST https://keepbal.com/apis/v1/tavily/search` — Web search with extracted page text (Tavily) (12000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/tavily/extract` — Extract content from known URLs (Tavily) (6000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/exa/search` — Neural semantic web search (Exa) (12000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/exa/contents` — Fetch full page contents (Exa) (6000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/firecrawl/scrape` — Scrape a page to clean markdown (Firecrawl) (6000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/firecrawl/search` — Web search returning scraped content (Firecrawl) (12000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/scholar/search/scholar` — Academic paper search with citations (Scholar) (12000 micro-USD / 2xx call)
- `POST https://keepbal.com/apis/v1/scholar/search/web` — Research-oriented web search (Scholar) (12000 micro-USD / 2xx call)

In the temporary validation mode reported by /healthz, catalog tool paths may be forwarded. A 2xx call is billed at the catalog price. direct implements Tavily search/extract only; other direct routes return 503 and are not billed.
A path not in this list is 15000 micro-USD on a 2xx response, except `monid_validation` discover/inspect/run/runs which use the Digidai-facing routes below.

When /healthz reports `monid_validation` (temporary adapter, not a white-label):
- `POST https://keepbal.com/apis/v1/discover` — not billed
- `POST https://keepbal.com/apis/v1/inspect` — not billed
- `POST https://keepbal.com/apis/v1/run` — Digidai debit = upstream quoted USD (pass-through + documented markup_bps, default 0) only on completed provider-success. Provider 4xx/5xx, FAILED, BLOCKED, TIMED_OUT, and 202-in-flight are $0.
- `GET https://keepbal.com/apis/v1/runs` and `GET https://keepbal.com/apis/v1/runs/:runId` — list/poll; a previously unpaid successful run settles once
- `POST https://keepbal.com/apis/v1/runs/:runId/stop` — not billed at request time
- `GET https://keepbal.com/apis/v1/wallet/balance` — Digidai wallet, not an upstream provider wallet
Static catalog paths such as tavily/search return 503 in this mode and are not billed. Model /v1 inference also returns 503.

## Wallet

- Balance: `GET https://keepbal.com/v1/credits/balance`
- Usage: `GET https://keepbal.com/v1/usage`
- Signup grants $1 promotional credit; extra credit is an operator grant from /admin. No self-serve card or crypto payment yet.
- No email verification, password recovery, OAuth or MFA yet. Save your password.
- Model tokens are billed when the provider returns usage; settlement is asynchronous.
- A 2xx model response with no extractable token usage costs 0. Image pricing and non-OpenAI streaming usage are not implemented.
- Money is integer micro-USD (1 USD = 1,000,000)
- `402 insufficient_credits` — wallet below the configured floor
- `503 provider_unavailable` — no upstream for that route; never billed
- `501 not_implemented` — `/apis/v2/*` x402 is not available.

Always send `Authorization: Bearer dgk_live_...`. Errors use the OpenAI envelope `{"error":{"message","type","code","param","request_id"}}`. `request_id` matches the `x-digidai-request-id` header. Successful and rate-limited `/v1` and `/apis` responses include approximate `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (KV window, not an exact RPM counter). Those headers are listed in `Access-Control-Expose-Headers`.


---

# KeepBal expanded documentation (llms-full)

Canonical pages below are also served as HTML and as `.md` / `Accept: text/markdown` mirrors.

# What is KeepBal?

KeepBal is Digidai’s agent capability layer: one `dgk_live_` key for OpenAI-compatible models and priced tools, settled in a wallet you can audit.

## Definition (one sentence)

Issue a Digidai key. Call OpenAI-compatible `/v1` and priced `/apis` tools. Settle usage in integer micro-USD. Digidai owns the account, the key, and the ledger.

## What KeepBal is

- A Digidai-owned HTTP product on Cloudflare Workers (`digidai-capability-gateway`).
- Primary public host: https://keepbal.com (aliases exist; they canonicalize here).
- One key prefix: `dgk_live_`.
- Models under `/v1` (OpenAI-compatible) and tools under `/apis/v1`.
- Money as integer micro-USD (1 USD = 1,000,000).

## What KeepBal is not

- Not KeepRouter (sister model-routing product, separate API).
- Not a live MCP or A2A server (discovery stubs only; transport planned).
- Not a white-label of an upstream vendor. Temporary upstream adapters (see `/healthz` and `llms.txt`) are not the product.
- Not self-serve card/crypto checkout. Signup grants $1 promotional credit; extra credit is an operator grant.
- Not an SLA over catalog rows. Catalogs are candidates.

## Fail-closed billing

If the current upstream mode has no provider for a route, KeepBal returns `503 provider_unavailable` and does **not** bill. That is intentional.

## Start

1. https://keepbal.com/sign-up
2. Create a key at https://keepbal.com/console/keys (shown once)
3. `GET https://keepbal.com/healthz` then read https://keepbal.com/llms.txt and https://keepbal.com/SKILL.md

Former public name: Wirecap.

---

# KeepBal docs index

Read these before a metered call. Prefer machine-readable sources when building an agent.

## For agents (start here)

1. https://keepbal.com/SKILL.md — setup skill
2. https://keepbal.com/llms.txt — short contract + catalog prices
3. https://keepbal.com/llms-full.txt — expanded quotable docs
4. https://keepbal.com/openapi.yaml — OpenAPI 3.1
5. https://keepbal.com/catalog.json — machine-readable catalog
6. https://keepbal.com/.well-known/agent-card.json — Agent Card
7. https://keepbal.com/.well-known/mcp.json — HTTP tool list only (MCP transport planned, not live)
8. https://keepbal.com/healthz — live product + upstream_mode

## For humans

| Page | Purpose |
| --- | --- |
| https://keepbal.com/about | What is KeepBal |
| https://keepbal.com/quickstart | curl / Python / JS |
| https://keepbal.com/pricing | Prices and limits |
| https://keepbal.com/faq | FAQ |
| https://keepbal.com/compare | Why KeepBal vs routers and tool gateways |
| https://keepbal.com/changelog | Changelog |
| https://keepbal.com/sign-up | Create account |

## Markdown mirrors

Append `.md` or send `Accept: text/markdown` on docs pages (for example https://keepbal.com/pricing.md).

## Honesty

MCP/A2A not live. x402 `/apis/v2` returns 501. No self-serve payment. Temporary validation adapters are not the product.

---

# Pricing and limits

KeepBal bills in **integer micro-USD** (1 USD = 1,000,000). Prices below are Digidai catalog prices, not live vendor invoices. Availability depends on `GET https://keepbal.com/healthz` upstream_mode.

## Wallet basics

- Signup grants **$1 promotional credit** once.
- Extra credit is an **operator grant** from /admin. **No self-serve card or crypto payment.**
- Metered calls settle **asynchronously**. Balance can lag. Concurrent calls can pass the precheck — not a hard spend cap.
- `402 insufficient_credits` — wallet below the configured floor.
- `503 provider_unavailable` — no upstream for that route; **never billed**.
- `501 not_implemented` — `/apis/v2/*` x402 is not available.

## Models (per 1M tokens)

| Model | Owned by | Endpoint | Input µUSD / 1M | Output µUSD / 1M |
| --- | --- | --- | --- | --- |
| `gpt-5.4` | openai | chat/completions | 3000000 | 12000000 |
| `gpt-5.4-mini` | openai | chat/completions | 600000 | 2400000 |
| `claude-sonnet-4.5` | anthropic | chat/completions | 3600000 | 18000000 |
| `claude-haiku-4.5` | anthropic | chat/completions | 1200000 | 6000000 |
| `gemini-2.5-pro` | google | chat/completions | 1500000 | 12000000 |
| `gemini-2.5-flash` | google | chat/completions | 360000 | 3000000 |
| `deepseek-v3.2` | deepseek | chat/completions | 336000 | 504000 |
| `qwen3-max` | alibaba | chat/completions | 1440000 | 7200000 |
| `jina-embeddings-v3` | jina | embeddings | 60000 | 0 |

Unknown model ids may be forwarded in some temporary validation modes and billed at input 2400000 / output 9600000 micro-USD per 1M tokens. Availability depends on `/healthz` — see https://keepbal.com/llms.txt for mode notes. `direct` model routes currently return 503.

A 2xx model response with no extractable token usage costs 0. Image pricing and non-OpenAI streaming usage are not implemented.

## Tools (per successful 2xx call)

| Tool | Summary | µUSD / 2xx |
| --- | --- | --- |
| `POST /apis/v1/tavily/search` | Web search with extracted page text (Tavily) | 12000 |
| `POST /apis/v1/tavily/extract` | Extract content from known URLs (Tavily) | 6000 |
| `POST /apis/v1/exa/search` | Neural semantic web search (Exa) | 12000 |
| `POST /apis/v1/exa/contents` | Fetch full page contents (Exa) | 6000 |
| `POST /apis/v1/firecrawl/scrape` | Scrape a page to clean markdown (Firecrawl) | 6000 |
| `POST /apis/v1/firecrawl/search` | Web search returning scraped content (Firecrawl) | 12000 |
| `POST /apis/v1/scholar/search/scholar` | Academic paper search with citations (Scholar) | 12000 |
| `POST /apis/v1/scholar/search/web` | Research-oriented web search (Scholar) | 12000 |

A path not in this list is 15000 micro-USD on a 2xx response, except Digidai-facing discover/inspect/run routes when those are active (see https://keepbal.com/llms.txt).

When a temporary tools adapter is active, some static catalog paths may return 503 (not billed) while Digidai-facing discover/inspect/run settle per llms.txt.

## Machine-readable

https://keepbal.com/catalog.json · https://keepbal.com/llms.txt · https://keepbal.com/openapi.yaml

---

# KeepBal FAQ

## What is KeepBal?

KeepBal is Digidai’s agent capability layer: one dgk_live_ key for OpenAI-compatible models and priced tools, settled in a wallet you can audit.

## How do I give this to an agent?

Paste set up https://keepbal.com/SKILL.md into the agent chat. Then create an account, issue a dgk_live_ key, and keep the secret. It is shown once.

## How does money work?

Signup grants $1 promotional credit once. 1 USD = 1,000,000 integer micro-USD. Metered calls settle asynchronously. Extra credit is an operator grant. There is no card or crypto checkout.

## What if a route has no provider?

If no provider is configured for that route, the call returns 503 and is not billed. Check /healthz, then read the pricing table and llms.txt. Digidai owns the wallet either way — temporary upstream adapters are not the product.

## Can I connect through MCP?

No. MCP and A2A transports are not live. Use HTTP and the console setup prompt. Agent Card and discovery files describe the HTTP API. They are not protocol servers.

## How do I start?

Create an account, save the password, create a key, and copy it while it is visible. Call GET /v1/models for free, check /healthz, then try a supported metered call. Read usage after the queue settles.

## Can I recover my password?

No. Password recovery and email verification are not available. Save the password. You can change it in Settings while signed in if you know the current password.

## Is this KeepRouter?

No. KeepBal is Digidai’s agent capability layer. KeepRouter is a sister model-routing product, not this API. capability-gateway is an engineering name.

More: https://keepbal.com/docs · https://keepbal.com/pricing · https://keepbal.com/compare · https://keepbal.com/SKILL.md · mailto:hello@keepbal.com

Next: https://keepbal.com/sign-up

---

# KeepBal quickstart

## 1. Account and key

1. Open https://keepbal.com/sign-up (email + 12–128 character password; password recovery is not available).
2. Create a key at https://keepbal.com/console/keys. The secret is shown once.
3. Always send `Authorization: Bearer dgk_live_...`.

## 2. Inspect the live contract (free)

```bash
curl -sS https://keepbal.com/healthz
curl -sS https://keepbal.com/llms.txt | head
curl -sS https://keepbal.com/catalog.json | head
```

## 3. List models (free, no usage row)

```bash
curl -sS https://keepbal.com/v1/models \
  -H "Authorization: Bearer dgk_live_YOUR_KEY"
```

## 4. Python (OpenAI SDK)

```python
from openai import OpenAI
client = OpenAI(base_url="https://keepbal.com/v1", api_key="dgk_live_YOUR_KEY")
print(client.models.list())
```

Metered chat only works when `/healthz` reports a mode that serves models. Some temporary tools-focused modes return 503 for model inference — check llms.txt.

## 5. JavaScript (fetch)

```js
const res = await fetch("https://keepbal.com/v1/models", {
  headers: { Authorization: "Bearer dgk_live_YOUR_KEY" },
});
console.log(await res.json());
```

## 6. Tools (metered on 2xx; mode-dependent)

When a temporary tools adapter is active, use Digidai-facing discover/inspect/run (see llms.txt). Some static catalog paths may return 503 in that mode.

```bash
# Example only when /healthz mode serves this path:
curl -sS https://keepbal.com/apis/v1/tavily/search \
  -H "Authorization: Bearer dgk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"KeepBal Digidai"}'
```

## 7. Wallet and usage

```bash
curl -sS https://keepbal.com/v1/credits/balance -H "Authorization: Bearer dgk_live_YOUR_KEY"
curl -sS https://keepbal.com/v1/usage -H "Authorization: Bearer dgk_live_YOUR_KEY"
```

Paste into an agent: `set up https://keepbal.com/SKILL.md`

---

# Changelog

Public product notes. Engineering Worker name: `digidai-capability-gateway`. Former public name: Wirecap.

## 2026-10-05

- IndexNow key + submit script; conversion compare pages (`/compare/why-keepbal`, `/compare/model-routers`, `/compare/tool-gateways`); `security.txt` contacts hello@ / security@keepbal.com.
- Primary public host is https://keepbal.com (aliases: www.keepbal.com, keepbal.dev, wirecap.keeprouter.com, agent.keeprouter.com — no whole-site redirect; HTML canonical points to keepbal.com).
- Production temporary tools adapter (discover/inspect/run). Not a white-label. Digidai owns the product.
- Homepage narrative polish (flat paper design).
- SEO / GEO / AEO pass: expanded sitemap, robots AI-bot allows, JSON-LD, og:image, llms-full.txt, catalog.json, crawlable docs pages, security.txt, alias HTML noindex header.

## Earlier (Wirecap era → KeepBal)

- Digidai-owned accounts, `dgk_live_` keys, micro-USD wallet, OpenAPI, llms.txt, Agent Card, SKILL.md.
- Fail-closed `503` with no billing when a route has no provider.
- Honesty lock: MCP planned (not live), no self-serve payment, x402 returns 501, catalogs are candidates.

Check live mode: https://keepbal.com/healthz

---

# Compare KeepBal

KeepBal is Digidai’s agent capability layer: one `dgk_live_` key for OpenAI-compatible models and priced tools, settled in a wallet you can audit.

| Page | Focus |
| --- | --- |
| https://keepbal.com/compare/why-keepbal | Why KeepBal — ownership, wallet, fail-closed billing |
| https://keepbal.com/compare/model-routers | KeepBal vs OpenAI-compatible model routers |
| https://keepbal.com/compare/tool-gateways | KeepBal vs tools-only / capability gateways |

## Why teams start here

| Benefit | KeepBal |
| --- | --- |
| Digidai ownership | Your account, `dgk_live_` key, and ledger — not a white-label |
| Models + tools | OpenAI-compatible `/v1` and priced `/apis` on one key |
| Auditable wallet | Integer micro-USD you can inspect in the console |
| Fail-closed | Unsupported routes return `503` and are **not billed** |
| Honest early access | MCP planned; $1 promo; no self-serve card checkout yet |

**Start:** https://keepbal.com/sign-up · **Console:** https://keepbal.com/console · **Contract:** https://keepbal.com/llms.txt

---

# KeepBal vs OpenAI-compatible model routers

**KeepBal** gives agents one Digidai `dgk_live_` key for OpenAI-compatible models **and** priced tools, settled in an auditable micro-USD wallet Digidai owns.

OpenRouter-style products sit in the “point an OpenAI SDK at a base URL” category. This page does **not** invent another product’s prices or SLAs — it highlights KeepBal’s shipped contract.

| Topic | KeepBal | Typical model router |
| --- | --- | --- |
| Identity | Digidai account + `dgk_live_` | Router / provider keys |
| Models | OpenAI-compatible `/v1` | Usually `/v1` chat |
| Tools | Priced `/apis/v1` on the **same** key | Often models-only |
| Wallet | Digidai integer micro-USD ledger | Varies |
| Unavailable route | `503` **not billed** | Product-specific |
| Sister product | KeepRouter is separate | — |

## Why signup

- Digidai owns the account, key hash, and usage rows.
- Models and HTTP tools share one key and one wallet.
- Early access is honest: $1 promo, MCP planned, no self-serve pay yet.

**Create account:** https://keepbal.com/sign-up · **Console:** https://keepbal.com/console · **Also:** https://keepbal.com/compare/openrouter redirects here.

---

# KeepBal vs tool / capability gateways

**KeepBal** is Digidai’s agent capability layer: OpenAI-compatible models and priced tools behind one `dgk_live_` key, settled in a Digidai-owned micro-USD wallet.

Many “tool gateway” products focus on HTTP tools or agent plugins alone. KeepBal’s differentiator is **Digidai ownership of identity + ledger** with models and tools on the same key — not a white-label of an upstream vendor.

| Topic | KeepBal | Tools-only gateway (category) |
| --- | --- | --- |
| Identity | Digidai `dgk_live_` | Often third-party or upstream keys |
| Models | `/v1` on the same key | Often separate or absent |
| Tools | Priced `/apis/v1` | Usually the primary surface |
| Wallet | Digidai auditable micro-USD | Varies / upstream balance |
| Fail closed | `503` not billed | Product-specific |
| Branding | KeepBal by Digidai | — |

## Signup pitch

- One key for agents that need both chat and tools.
- Usage settles in a wallet Digidai owns — inspect balance and usage in the console.
- Unsupported routes return `503` with **no charge**.

Technical upstream adapter notes (validation modes, discover/inspect/run) live in https://keepbal.com/llms.txt and `GET https://keepbal.com/healthz` — not on this marketing page.

**Create account:** https://keepbal.com/sign-up · **Console:** https://keepbal.com/console

---

# Why KeepBal

KeepBal is Digidai’s agent capability layer. Digidai owns the account, the `dgk_live_` key, and the micro-USD wallet.

## Proof points

1. **Own key** — `Authorization: Bearer dgk_live_...` issued in the Digidai console.
2. **Models + tools** — OpenAI-compatible `/v1` and priced `/apis/v1` on that key.
3. **Auditable wallet** — integer micro-USD (1 USD = 1,000,000); balance and usage in the console.
4. **Fail-closed** — no provider for a route → `503 provider_unavailable`, **not billed**.
5. **Honest early access** — MCP planned; $1 promo; no self-serve pay; KeepRouter is sister, not this API.

## Start in three steps

1. https://keepbal.com/sign-up — create an account (save the password).
2. https://keepbal.com/console/keys — issue a key (shown once).
3. `GET https://keepbal.com/healthz` then call a supported route with your key.

Contract: https://keepbal.com/llms.txt · https://keepbal.com/SKILL.md · https://keepbal.com/openapi.yaml