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

# Credits & Billing

> Pay-as-you-go credits for platform services

The Open Animate platform uses a prepaid credit system. Purchase credits via Stripe and they're deducted per-operation as you use asset generation and cloud rendering.

## Check your balance

```bash theme={null}
oanim billing
```

Shows your current credit balance and recent purchase history.

<Note>
  New accounts receive **\$5.00 in free credits** on signup. No credit card required to get started.
</Note>

## Purchase credits

```bash theme={null}
oanim billing buy --amount 25
```

| Detail           | Value             |
| ---------------- | ----------------- |
| Minimum purchase | \$5               |
| Bonus threshold  | \$50+             |
| Bonus amount     | 10% extra credits |

**Example:** A $100 purchase gets you $110 in credits.

The command opens a Stripe checkout page in your browser. After payment completes, credits are added to your account immediately.

## What happens when credits run out

When your balance reaches \$0, asset generation and cloud render requests will fail with an insufficient credits error. Local operations (`oanim init`, `oanim render` without `--cloud`) are always free and unaffected.

To continue using platform services, either:

* Purchase more credits: `oanim billing buy --amount 10`
* Use a direct provider key: `export ANIMATE_FAL_KEY=your-key`

## Asset generation costs

Costs are per-operation and vary by model:

### Image generation

| Model                                 | Cost    |
| ------------------------------------- | ------- |
| `fal-ai/flux/schnell`                 | \$0.003 |
| `fal-ai/flux-2-flex` (default)        | \$0.05  |
| `fal-ai/recraft/v4/text-to-image`     | \$0.04  |
| `fal-ai/recraft/v4/pro/text-to-image` | \$0.06  |
| `fal-ai/ideogram/v3`                  | \$0.06  |
| `fal-ai/nano-banana-2`                | \$0.08  |

### Image editing

| Model                               | Cost   |
| ----------------------------------- | ------ |
| `fal-ai/flux-pro/kontext` (default) | \$0.04 |
| `fal-ai/nano-banana-2/edit`         | \$0.08 |
| `fal-ai/reve/edit`                  | \$0.04 |

### Background removal

| Model                           | Cost    |
| ------------------------------- | ------- |
| `fal-ai/birefnet` (default)     | \$0.005 |
| `fal-ai/bria/background/remove` | \$0.018 |

### Upscaling

| Model                                    | Cost   |
| ---------------------------------------- | ------ |
| `fal-ai/bria/upscale/creative` (default) | \$0.03 |
| `fal-ai/topaz/upscale/image`             | \$0.08 |

### Video generation

| Model                                             | Cost   |
| ------------------------------------------------- | ------ |
| `fal-ai/minimax/hailuo-02/standard/text-to-video` | \$0.27 |
| `fal-ai/kling-video/v2.5-turbo/pro/text-to-video` | \$0.35 |
| `fal-ai/kling-video/v3/pro/text-to-video`         | \$1.12 |
| `fal-ai/veo3.1`                                   | \$1.00 |
| `fal-ai/sora-2/text-to-video/pro`                 | \$1.50 |

### Audio / speech

| Model                              | Cost   |
| ---------------------------------- | ------ |
| `beatoven/music-generation`        | \$0.05 |
| `beatoven/sound-effect-generation` | \$0.05 |
| `minimax/speech-02-hd`             | \$0.05 |

### Other

| Model                        | Cost             |
| ---------------------------- | ---------------- |
| `fal-ai/flux/dev/controlnet` | \$0.03           |
| `fal-ai/flux/dev/ip-adapter` | \$0.03           |
| `fal-ai/lora`                | \$0.02           |
| Unknown models               | \$0.05 (default) |

## Cost controls

Set a per-session cost limit to prevent runaway spending:

```bash theme={null}
export ANIMATE_MAX_USD_PER_RUN=5.00
```

The CLI will refuse any operation that would push the session total over this limit.

## Direct provider key

If you prefer to skip the platform billing system, set `ANIMATE_FAL_KEY` with your own fal.ai API key. Requests go directly to fal.ai and are billed by them:

```bash theme={null}
export ANIMATE_FAL_KEY=your-fal-key
oanim assets gen-image --prompt "gradient" --out bg.png
```

This bypasses Open Animate credit checks entirely.