# FILM · Video Interpolation

Edit and transform video with FILM · Video Interpolation from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `fal-ai/film/video`
- Page: https://spiral.ai/tools/fal/fal-ai/film/video

## Pricing

Up to $0.1014 per run at the default inputs for 60 seconds of input.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `video_url` (required) | URL or file |  | — | The URL of the video to use for interpolation. |
| `num_frames` | number (whole) | 1 to 4 | 1 | The number of frames to generate between the input video frames. |
| `use_scene_detection` | true or false |  | false | If True, the input video will be split into scenes before interpolation. This removes smear frames between scenes, but can result in false positives if the scene detection is not accurate. If False, the entire video will be treated as a single scene. |
| `use_calculated_fps` | true or false |  | true | If True, the function will use the calculated FPS of the input video multiplied by the number of frames to determine the output FPS. If False, the passed FPS will be used. |
| `fps` | number (whole) | 1 to 60 | 8 | Frames per second for the output video. Only applicable if use_calculated_fps is False. |
| `loop` | true or false |  | false | If True, the final frame will be looped back to the first frame to create a seamless loop. If False, the final frame will not loop back. |
| `video_quality` | one of | low, medium, high, maximum | high | The quality of the output video. Only applicable if output_type is 'video'. |
| `video_write_mode` | one of | fast, balanced, small | balanced | The write mode of the output video. Only applicable if output_type is 'video'. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/film/video",
    "input": {
      "video_url": "https://storage.googleapis.com/falserverless/example_inputs/interpolation-video-input.mp4"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Ffilm%2Fvideo

## Common questions

### FILM · Video Interpolation

**How much does FILM · Video Interpolation cost?**

Up to $0.1014 per run at the default inputs for 60 seconds of input. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use FILM · Video Interpolation through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/film/video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use FILM · Video Interpolation?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use FILM · Video Interpolation?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

