> For the complete documentation index, see [llms.txt](https://capminal.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://capminal.gitbook.io/docs/capminal/opencap.md).

# OpenCAP

One key. Every model. Powered by your staked CAPU.

**OpenCAP** is a unified **LLM gateway** that lets you create an API key and tap into a wide range of AI models through a single, OpenAI-compatible endpoint:

```
https://gw.capminal.ai
```

Instead of juggling separate accounts, billing, and SDKs for every provider, you point your app at one base URL, authenticate with one key, and route requests to whichever model you need.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-4796f93c569efb556606ab6d17bb7bc8efb5883c%2Fopencap_models.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**No subscription. No credit card.** Your daily inference usage is funded by your **staked CAPU** — not a monthly bill.
{% endhint %}

{% hint style="info" %}
**Where does the free Inference Credit come from?** It's funded by **part of our revenue**, and we secure **bulk deals with our model providers** — so we can pass real inference capacity back to stakers at no extra cost.
{% endhint %}

## How it works

1. **Log in with your wallet.** Connect the wallet that holds your staked CAPU.
2. **Get daily Inference Credit.** Every wallet with **staked CAPU** is granted a daily allowance of Inference Credit — **$1 of inference usage per staked CAPU, every day**, renewed at 00:00 UTC. Don't have CAPU yet? See [Mint CAPU](/docs/capminal/product-features/mint-capu.md) to learn how to get and stake it.
3. **Create a key.** Generate an `OPENCAP_API_KEY` from the dashboard.
4. **Start building.** Use the key with any OpenAI-compatible client, terminal, or agent framework — your usage draws down your daily Inference Credit automatically.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-b0c5641cdfaba102fb676e13be215729673ec629%2Fopencap_dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Inference Credit is tied to your **staked** CAPU. Stake more CAPU → larger daily allowance. Credit resets every day and does **not** roll over.
{% endhint %}

### The full flow at a glance

```mermaid
flowchart LR
    CAP[💎 CAP<br/>your capital] -->|stake| SCAP[sCAP<br/>staking receipt]
    SCAP -->|lock & mint| CAPU[⚡ CAPU<br/>compute asset]
    BUY([or just buy CAPU]) -.-> CAPU
    CAPU -->|stake CAPU| CREDIT[💰 Inference Credit<br/>$1/day per CAPU]

    W([👤 Wallet login]) --> KEY[🔑 Create key<br/>OPENCAP_API_KEY]
    CREDIT -->|funds usage| KEY

    KEY --> APPS{{AI Apps}}
    APPS --> T[Terminal / curl / cli]
    APPS --> O[OpenClaw]
    APPS --> H[Hermes]

    classDef cap fill:#dbeafe,stroke:#2563eb,color:#1e3a8a;
    classDef capu fill:#dcfce7,stroke:#16a34a,color:#14532d;
    classDef reward fill:#fef9c3,stroke:#ca8a04,color:#713f12;
    classDef key fill:#ede9fe,stroke:#7c3aed,color:#4c1d95;
    class CAP,SCAP cap;
    class CAPU capu;
    class CREDIT reward;
    class KEY,APPS key;
```

Lock **CAP → sCAP → CAPU** (or simply buy CAPU), stake it to earn daily **Inference Credit**, then create an `OPENCAP_API_KEY` and point any AI app at the gateway — every request draws down your daily Credit.

***

## Two ways to fund your inference

You don't have to choose just one. Both sources fund the same `OPENCAP_API_KEY` — the gateway draws on whatever you have.

| Funding source                         | What it is                                                                                        | Best for                                                                                                                                |
| -------------------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Inference Credit from CAPU Staking** | A **daily allowance** — $1/day of inference per staked CAPU, renewed at 00:00 UTC, non-rolling.   | Steady, recurring usage you want to cover with capital you already hold. See [Mint CAPU](/docs/capminal/product-features/mint-capu.md). |
| **USDC Top-Up**                        | A **prepaid balance** you load with USDC. It doesn't reset — you spend it down until it runs out. | One-off bursts, spikes above your daily allowance, or anyone who'd rather just pay as they go.                                          |

Your daily staking Credit is used first; once it's exhausted, the gateway falls back to your topped-up USDC balance. Stake for the everyday baseline, top up for the headroom.

### Top-Up Inference with USDC

Want more inference without staking — or just a buffer for heavy days? **Top up your balance directly with USDC**, with payment powered by **MoonPay**.

1. **Open the Top-Up card** on your dashboard and hit **Top-Up USDC**.
2. **Pay with USDC** — or any supported asset, which is **auto-swapped to USDC for you, with gas covered**.
3. **Get credited automatically** once the on-chain transaction confirms. The balance shows up on your dashboard — no manual steps.
4. **Spend it anytime.** Unlike daily Credit, your topped-up balance **does not reset** — it carries over until you use it.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-67123fc7d39f03a3032db815b67b3d0e0bdd1f4c%2Fopencap_topup.png?alt=media" alt=""><figcaption><p>The Top-Up · USDC card on your dashboard, alongside your CAPU staking quota.</p></figcaption></figure>

#### Two ways to pay

When you open the deposit panel, you can choose how to send your funds:

* **Transfer Manually (QR)** — scan the QR or copy the address and send from any wallet or exchange. Works with USDC and other supported assets. No limit · instant.
* **Connect Wallet** — connect a wallet (MetaMask, Coinbase, WalletConnect, and more) and pay in a couple of clicks, right from the browser. No limit · instant.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-b75e42934d05dfcf318973246a1923ddd29f961c%2Fopencap_topup_methods.png?alt=media" alt=""><figcaption><p>Pick a deposit method — Transfer Manually by QR, or Connect Wallet to pay directly.</p></figcaption></figure>

{% hint style="info" %}
**Powered by MoonPay & Helio.** Checkout runs inside the dashboard through the official MoonPay widget. Your deposit is credited **server-side after the on-chain transaction is confirmed**, so closing the window mid-flow never loses a confirmed payment.
{% endhint %}

{% hint style="success" %}
**Small deposits aren't lost.** If you send less than the minimum, the amount is **parked** and activates automatically once your total reaches the minimum — you'll see the progress on the Top-Up card.
{% endhint %}

### Redeem an Inference Voucher

Got a `CAP-…` voucher code? Redeem it on the dashboard and the credit lands on your balance **instantly** — no wallet payment, no on-chain wait.

1. Go to [capminal.ai/gateway](https://www.capminal.ai/gateway) and hit **Connect Wallet** to sign in.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-c7a18ade7d38996cff15f1b174055ab30c74a8f1%2Fopencap_voucher_signin.png?alt=media" alt=""><figcaption><p>Sign in with your wallet to open the dashboard.</p></figcaption></figure>

2. Scroll to the **Top-Up · USDC** card and click **Redeem Voucher Code**.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-37579d26d3c283c6dbdd024ce582a8634dd07b66%2Fopencap_voucher_button.png?alt=media" alt=""><figcaption><p>The Redeem Voucher Code button sits right under Top-Up USDC.</p></figcaption></figure>

3. Paste your code (`CAP-XXXXX-XXXXX-XXXXX-XXXXX`) and hit **Redeem**. Your balance updates on the spot.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-c9d33ef7f1bd4abc77ff2288b375eb20df09252d%2Fopencap_voucher_input.png?alt=media" alt=""><figcaption><p>Enter the voucher code and redeem.</p></figcaption></figure>

4. Scroll down to the **API Keys** card, click **+ Create Key**, name it, and confirm — you now have an `OPENCAP_API_KEY` funded by the voucher.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-ba92f5dc55df0f4cb07a5e2dfb24dc2092e1675b%2Fopencap_voucher_createkey.png?alt=media" alt=""><figcaption><p>Create an API key to start spending your voucher balance.</p></figcaption></figure>

{% hint style="warning" %}
A voucher credits its **exact face value** — the top-up bonus doesn't apply. Codes are **single-use** and limited to **one voucher per account**, so a redeem can't be undone.
{% endhint %}

***

## Quick Start

After creating your key, here are a few ways to start using OpenCAP.

**Base URL**

```
https://gw.capminal.ai/api/inference/v1
```

### Use in Terminal

```bash
export OPENCAP_API_KEY="ocap_..."

curl https://gw.capminal.ai/api/inference/v1/chat/completions \
  -H "Authorization: Bearer $OPENCAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "messages": [{"role": "user", "content": "Hello from OpenCAP"}],
    "stream": true
  }'
```

### Pin a provider (optional)

For a **combo model**, add a provider allow-list (a gateway id or an array) to route only to those gateways. Omit it and the combo picks the cheapest. Unknown providers are ignored; if none match you get `400 unsupported_provider`.

```bash
curl https://gw.capminal.ai/api/inference/v1/chat/completions \
  -H "Authorization: Bearer $OPENCAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "provider": ["surplus", "virtuals"],
    "messages": [{"role": "user", "content": "Hello from OpenCAP"}]
  }'
```

{% hint style="info" %}
**Supported providers:** `openrouter`, `surplus`, `virtuals`, `venice-ai`.
{% endhint %}

### Use in OpenClaw

```json
// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "opencap": {
        "baseUrl": "https://gw.capminal.ai/api/inference/v1",
        "api": "openai-completions",
        "key": "${OPENCAP_API_KEY}",
        "models": [
          {
            "id": "claude-opus-4.8",
            "name": "Claude Opus 4.8",
            "contextWindow": 200000,
            "maxTokens": 32000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "opencap/claude-opus-4.8" }
    }
  }
}
```

### Use in Hermes

```yaml
# ~/.hermes/.env
OPENCAP_API_KEY=ocap_...

# ~/.hermes/config.yaml
model:
  provider: custom:opencap
  default: claude-opus-4.8
  base_url: https://gw.capminal.ai/api/inference/v1
  api_key: ${OPENCAP_API_KEY}
  api_mode: chat_completions
```

### Use in OpenCode

```json
// ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "opencap": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenCAP",
      "options": {
        "baseURL": "https://gw.capminal.ai/api/inference/v1",
        "apiKey": "{env:OPENCAP_API_KEY}"
      },
      "models": {
        "claude-opus-4.8": {
          "name": "Claude Opus 4.8"
        }
      }
    }
  }
}
```

***

{% hint style="warning" %}
Keep your `OPENCAP_API_KEY` secret. Anyone with your key can spend your daily Inference Credit. You can revoke and regenerate keys at any time from the dashboard.
{% endhint %}

{% hint style="danger" %}
**Important:** `CAP_API_KEY` and `OPENCAP_API_KEY` are different keys. `CAP_API_KEY` controls your Capminal Agentic Wallet, while `OPENCAP_API_KEY` gives access to OpenCAP for using LLM models.
{% endhint %}

Open any key to see its live spend, usage, and budget — set a per-key daily cap, change its expiration, or revoke it on the spot.

<figure><img src="https://3845772366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTIiIHjbP3ydnk8ftUvYP%2Fuploads%2Fgit-blob-6c56f6671ca7287f24b3947fd816984089061e7f%2Fopencap_detail_key.png?alt=media" alt=""><figcaption></figcaption></figure>