> ## Documentation Index
> Fetch the complete documentation index at: https://crevio.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage & billing

> Crevio is metered pay-per-call on credits — check your balance and spend with GET /usage, see per-charge history with GET /usage/transactions, and price AI media generation.

**The Crevio API is metered pay-per-call: AI work is billed in credits drawn from your account balance.** Plain CRUD (listing products, reading orders) is cheap or free; the spend comes from AI operations — chat messages, media generation, Tasks, web research, and phone calls.

Two endpoints give you full visibility: `GET /usage` for your current plan, balance, and spend breakdown, and `GET /usage/transactions` for the individual metered charges behind it.

## Check your balance and spend

`GET /usage` returns your plan, remaining credit balance, and a per-operation spend breakdown for the current billing period.

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl https://api.crevio.co/v1/usage \
      -H "Authorization: Bearer $CREVIO_API_TOKEN"
    ```
  </Tab>

  <Tab title="SDK (TypeScript)">
    ```typescript theme={null}
    const usage = await crevio.usage.get();
    console.log(usage.credits.balance);
    ```
  </Tab>

  <Tab title="MCP (agent)">
    ```text theme={null}
    How many Crevio credits do I have left, and what's been using them this month?
    ```
  </Tab>
</Tabs>

A real response:

```json theme={null}
{
  "object": "usage",
  "plan": {
    "name": "Business",
    "status": "active",
    "is_paid": true,
    "on_trial": false,
    "trial_ends_at": null,
    "renews_at": "2026-07-01T00:00:00Z"
  },
  "credits": { "balance": 18450 },
  "spend": {
    "period_start": "2026-06-01T00:00:00Z",
    "period_end": "2026-06-30T23:59:59Z",
    "total_credits": 6210,
    "by_operation": [
      { "operation": "ai_message", "description": "AI chat messages", "credits": 3120 },
      { "operation": "image_generation", "description": "Image generation", "credits": 1840 },
      { "operation": "task_run", "description": "Task runs", "credits": 980 },
      { "operation": "web_research", "description": "Web research", "credits": 270 }
    ]
  }
}
```

<ResponseField name="plan" type="object">
  Your current plan: `name`, `status`, `is_paid`, `on_trial`, `trial_ends_at`, `renews_at`.
</ResponseField>

<ResponseField name="credits.balance" type="integer">
  Credits remaining on the account.
</ResponseField>

<ResponseField name="spend" type="object">
  Period spend: `period_start`, `period_end`, `total_credits`, and `by_operation[]` (each `{ operation, description, credits }`).
</ResponseField>

## See individual charges

`GET /usage/transactions` lists each metered charge so you can attribute spend precisely.

```bash theme={null}
curl "https://api.crevio.co/v1/usage/transactions?limit=20" \
  -H "Authorization: Bearer $CREVIO_API_TOKEN"
```

It returns the standard list envelope (`object: "list"`, `data`, `has_more`) — paginate it with `limit` and `starting_after` like any other [list endpoint](/developer/guides/conventions#pagination).

## What consumes credits

Operations that run AI or external compute are metered:

| Operation        | What it covers                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------ |
| AI messages      | Chat and agent reasoning turns.                                                            |
| Media generation | Images, video, and audio (`POST /images/generate`, `/videos/generate`, `/audio/generate`). |
| Tasks            | Each Task run (your scheduled AI workforce).                                               |
| Web research     | `POST /web/research` and other `/web/*` tools.                                             |
| Phone calls      | AI inbound/outbound calls (`POST /calls`), billed per minute.                              |

Reading and managing your own data (products, orders, customers, webhooks) is not AI-metered.

## AI media pricing

Media generation is priced in **USD** per unit and converted to credits. Pick the cheapest model that meets your quality bar — the default is the most economical.

### Images (per megapixel, unless noted)

| Model                           | Price          |
| ------------------------------- | -------------- |
| `fal-ai/flux/schnell` (default) | \$0.003 / MP   |
| `fal-ai/flux/dev`               | \$0.025 / MP   |
| `fal-ai/flux-pro/v1.1`          | \$0.04 / MP    |
| `fal-ai/recraft-v3`             | \$0.04 / image |

### Video (per second, unless noted)

| Model                               | Price          |
| ----------------------------------- | -------------- |
| Kling v1.6 standard (text-to-video) | \$0.056 / s    |
| Kling v1.6 pro (image-to-video)     | \$0.098 / s    |
| MiniMax `video-01`                  | \$0.50 / video |
| Luma Dream Machine                  | \$0.50 / video |

### Audio / TTS (per 1,000 characters)

| Model                                  | Price             |
| -------------------------------------- | ----------------- |
| ElevenLabs `multilingual-v2` (default) | \$0.10 / 1k chars |
| ElevenLabs `turbo-v2.5`                | \$0.05 / 1k chars |
| MiniMax `speech-02-hd`                 | \$0.10 / 1k chars |

<Tip>
  Generated media lands in your Media Library as a `file_…` id you can reuse — for example in a product's `images` array. Always reuse the file id rather than re-generating.
</Tip>

<Note>
  Run `GET /images/models`, `GET /videos/models`, and `GET /audio/models` for the live model list — new models appear there before this table is updated.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Conventions" icon="list-check" href="/developer/guides/conventions">
    List envelopes and pagination apply to transactions too.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/developer/guides/errors">
    How balance and rate issues surface.
  </Card>

  <Card title="MCP & agents" icon="robot" href="/developer/mcp">
    Tasks and agent work are the main credit consumers.
  </Card>

  <Card title="API reference" icon="code" href="/developer/api-reference/introduction">
    Full usage and media generation schemas.
  </Card>
</CardGroup>