# H3 Max Insert Video

> Run H3 Max Insert Video by falai online or via API. From $0.05 per second, no setup.

**URL:** https://inference.sh/apps/falai/minimax-h3-max-insert-video
**Last updated:** 2026-10-20

---

Insert a newly generated scene into an existing video with MiniMax H3 Max via fal. Pick where the scene starts and where the original resumes; guide it with a prompt and references.

- app: `falai/minimax-h3-max-insert-video`
- maker: [falai](https://inference.sh/apps/falai.md)
- category: [video](https://inference.sh/apps/category/video.md)
- input → output: video → video
- tasks: [video to video](https://inference.sh/apps/tag/video-to-video.md), [video editing](https://inference.sh/apps/tag/video-editing.md)
- price: $0.05/sec 480p, $0.06/sec 768p
- runs via: api, javascript and python sdk, belt cli, mcp

## minimax-h3-max-insert-video API Guide

### About
insert a newly generated scene into an existing video with minimax h3 max via fal. pick where the scene starts and where the original resumes; guide it with a prompt and references.

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Setup Your API Key
Set `INFERENCE_API_KEY` as an environment variable. Get your key from settings → api keys.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

#### Run and Get Result

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


result = client.run({
        "app": "falai/minimax-h3-max-insert-video@6w9zjc6p",
        "input": {
            "video": "https://example.com/file.png",
            "start_time": 1.625,
            "resume_time": 1.625,
            "prompt": "A red fox darts across the path and vanishes into the bushes."
        }
    })

print(result["output"])
```

#### Stream Live Updates

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


## stream=True yields updates as they arrive
for update in client.run({
        "app": "falai/minimax-h3-max-insert-video@6w9zjc6p",
        "input": {
            "video": "https://example.com/file.png",
            "start_time": 1.625,
            "resume_time": 1.625,
            "prompt": "A red fox darts across the path and vanishes into the bushes."
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

### 2. Authentication
The API uses API keys for authentication. See the authentication docs for detailed setup instructions.

### 3. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "falai/minimax-h3-max-insert-video@6w9zjc6p",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 4. Schema

#### Input
- **video** (string) *required*: Source video to insert a scene into.
- **start_time** (number) *required*: Seconds into the source where the generated scene begins.
- **resume_time** (number) *required*: Seconds into the source where the original footage resumes. Must be after start_time, with footage remaining after it.
- **duration** (number): Length of the generated scene in seconds (5-13).
- **prompt** (string): What happens in the inserted scene.
- **reference_images** (array): Reference images guiding the inserted scene (max 9).
- **reference_videos** (array): Reference videos guiding the inserted scene (max 3).
- **resolution** (string): Output resolution.
- **enable_prompt_expansion** (boolean): Enhance the prompt using the source video.
- **color_match** (boolean): Match the inserted scene's color to the source footage.
- **seed** (integer): Random seed for reproducible generation.

#### Output
- **duration** (number): Total length of the final video in seconds.
- **expanded_prompt** (string): The prompt used after expansion.
- **injected_duration** (number): Length of the generated scene in seconds.
- **seed** (integer): Seed used for generation.
- **video** (string): The final video with the inserted scene.

## other video apps

- [H3 Max Styles](https://inference.sh/apps/falai/minimax-h3-max-styles.md): $0.08/sec (768P)
- [H3 Max 3D to Video](https://inference.sh/apps/falai/minimax-h3-max-3d-to-video.md): $0.50/request + $0.05/sec (480P), $0.08/sec (768P), $0.16/sec (1080P) + $0.10/generated ref; 5s min
- [H3 Max Recast](https://inference.sh/apps/falai/minimax-h3-max-recast.md): $0.30/sec at 768P, $0.45/sec at 1080P
- [H3 Max Relight](https://inference.sh/apps/falai/minimax-h3-max-relight.md): $0.05/s 480P, $0.08/s 768P, $0.16/s 1080P, $0.32/s 2K; up to 15s/video
- [H3 Max Lip Sync](https://inference.sh/apps/falai/minimax-h3-max-lip-sync.md): 480P $0.05/s, 768P $0.08/s, 1080P $0.16/s, 2K $0.32/s; +20% if >15s

## faq

### how much does H3 Max Insert Video cost?

$0.05/sec 480p, $0.06/sec 768p. you pay per run from your inference shell credits. no subscription is required.

### how do I run H3 Max Insert Video via api?

call falai/minimax-h3-max-insert-video with the javascript or python sdk, the rest api, or `belt app run falai/minimax-h3-max-insert-video` from a terminal. the api reference on this page lists every input.

### who makes H3 Max Insert Video?

H3 Max Insert Video is made by falai and runs on inference shell. every falai app is listed at https://inference.sh/apps/falai.

### can my agent use H3 Max Insert Video?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to H3 Max Insert Video?

other video apps on inference shell include H3 Max Styles, H3 Max 3D to Video, H3 Max Recast, H3 Max Relight. they run through the same api, so switching is a one-line change.