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

# Fal media catalog

> Opt into endpoint-level image and video generation with Fimo credits or your own Fal API key.

The Fal integration is an advanced escape hatch for media capabilities that Fimo's task commands do not cover. Keep ordinary image and video generation on the stable task commands in [Media & AI generation](/docs/cli/media).

## Use Fimo credits

Enable Fal in the current project, then search its live catalog:

```bash theme={null}
fimo integrations enable fal
fimo models list --search "video upscale"
```

Inspect a result before calling it:

```bash theme={null}
fimo models show fal/<endpoint-id>
fimo generate fal/<endpoint-id> --<required-flag> <value> --dry-run
```

The catalog, input flags, and per-unit prices come from Fal at runtime. Fimo does not ship a model list or a price table. A generation is blocked before it starts when its estimate exceeds the project's per-generation credit limit.

Run the generation after reviewing the estimate:

```bash theme={null}
fimo generate fal/<endpoint-id> --<required-flag> <value>
```

The response includes the provider cost, the Fimo credits charged, and `billingMode: "fimo-credits"`.

## Use your own Fal account

Store a project credential through standard input so the key does not appear in source code or command history:

```bash theme={null}
fimo integrations credentials set fal --stdin
fimo integrations auth use fal personal
```

Catalog and pricing requests use that same key, including account-specific discounts. Generations still pass through Fimo for validation, asset storage, and cost reporting, but the connected Fal account pays directly. The response reports the provider cost with `credits: 0` and `billingMode: "provider-account"`.

Dry-run estimates use the same billing mode, so personal auth shows the live provider cost with zero Fimo credits before anything is generated.

Switch back at any time:

```bash theme={null}
fimo integrations auth use fal fimo
```

## Available catalog

The first release includes active image and video generation categories that return media Fimo can store. Training, audio, 3D, and deprecated endpoints are excluded.