# H3 Max 3D to Video

> Run H3 Max 3D to Video by falai online or via API. Pay per run, no setup.

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

---

Turn a Blender or 3D previs render into photorealistic video with MiniMax H3 Max via fal. Layout, camera and timing follow the input; optional reference images set the look.

- app: `falai/minimax-h3-max-3d-to-video`
- maker: [falai](https://inference.sh/apps/falai.md)
- category: [video](https://inference.sh/apps/category/video.md)
- input → output: video → video, 3d → video
- tasks: [video to video](https://inference.sh/apps/tag/video-to-video.md), [3d to video](https://inference.sh/apps/tag/3d-to-video.md)
- price: $0.50/request + $0.05/sec (480P), $0.08/sec (768P), $0.16/sec (1080P) + $0.10/generated ref; 5s min
- runs via: api, javascript and python sdk, belt cli, mcp

## minimax-h3-max-3d-to-video API Guide

### About
turn a blender or 3d previs render into photorealistic video with minimax h3 max via fal. layout, camera and timing follow the input; optional reference images set the look.

### 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-3d-to-video@4m6tjq78",
        "input": {
            "video": "https://example.com/file.png"
        }
    })

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-3d-to-video@4m6tjq78",
        "input": {
            "video": "https://example.com/file.png"
        }
    }, 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-3d-to-video@4m6tjq78",
    "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*: Blender or previs render, up to 15 seconds and 32 shots.
- **prompt** (string): Optional clarification of what the proxies represent or how they move, e.g. 'The moving block is a running person.'
- **reference_images** (array): Optional environment, subject, interior or detail references (max 8). Used directly, without generating new images.
- **max_generated_reference_images** (integer): Max new appearance references to generate when no reference images are given. Each is billed by fal.
- **resolution** (string): Output quality. Duration follows the input video.

#### Output
- **video** (string): The finished realistic video, matching the input duration.

## other video apps

- [H3 Max Styles](https://inference.sh/apps/falai/minimax-h3-max-styles.md): $0.08/sec (768P)
- [H3 Max Insert Video](https://inference.sh/apps/falai/minimax-h3-max-insert-video.md): $0.05/sec 480p, $0.06/sec 768p
- [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 3D to Video cost?

$0.50/request + $0.05/sec (480P), $0.08/sec (768P), $0.16/sec (1080P) + $0.10/generated ref; 5s min. you pay per run from your inference shell credits. no subscription is required.

### how do I run H3 Max 3D to Video via api?

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

### who makes H3 Max 3D to Video?

H3 Max 3D to 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 3D to 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 3D to Video?

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