# VACE

> Run VACE by pruna online or via API. $0.40/video, no setup.

**URL:** https://inference.sh/apps/pruna/vace
**Last updated:** 2026-10-23

---

VACE-14B video generation and editing from a prompt, with optional source video, mask and up to 3 reference images for consistent characters.

- app: `pruna/vace`
- maker: [pruna](https://inference.sh/apps/pruna.md)
- category: [video](https://inference.sh/apps/category/video.md)
- input → output: text → video, video → video
- tasks: [text to video](https://inference.sh/apps/tag/text-to-video.md), [video to video](https://inference.sh/apps/tag/video-to-video.md)
- price: $0.40/video
- runs via: api, javascript and python sdk, belt cli, mcp

## vace API Guide

### About
vace-14b video generation and editing from a prompt, with optional source video, mask and up to 3 reference images for consistent characters.

### 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": "pruna/vace@6k1e4xck",
        "input": {
            "prompt": "prompt"
        }
    })

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": "pruna/vace@6k1e4xck",
        "input": {
            "prompt": "prompt"
        }
    }, 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": "pruna/vace@6k1e4xck",
    "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
- **prompt** (string) *required*: Description of the video. Be specific about characters, action, setting and camera.
- **src_video** (string): Source video to edit or transform.
- **src_mask** (string): Mask video or image marking the area of the source to edit.
- **src_ref_images** (array): Reference images for consistent characters (1-3 work best).
- **size** (string): Output resolution (width*height).
- **frame_num** (integer): Number of frames to generate (up to 81).
- **speed_mode** (string): Speed versus consistency.
- **sample_steps** (integer): Sampling steps. Higher is better and slower.
- **sample_solver** (string): Sampling algorithm.
- **sample_guide_scale** (number): How closely to follow the prompt.
- **sample_shift** (integer): Sample shift.
- **seed** (integer): Random seed for reproducible generation.

#### Output
- **seed** (integer): Seed used for generation.
- **video** (string): Generated video.

## other video apps

- [P-Video-Animate](https://inference.sh/apps/pruna/p-video-animate.md): $0.03/sec 720p, $0.06/sec 1080p
- [P-Video-Upscale](https://inference.sh/apps/pruna/p-video-upscale.md): Std: $0.01/sec 720p, $0.02 1080p, $0.04 2k, $0.08 4k; high fps 2x
- [P-Video-2-Pro-Avatar](https://inference.sh/apps/pruna/p-video-2-pro-avatar.md): $0.02/sec 480p, $0.04/sec 768p, $0.06/sec 1080p, $0.08/sec 2k, $0.12/sec 4k
- [P-Video-2-Pro-Reference](https://inference.sh/apps/pruna/p-video-2-pro-reference.md): Output: cost $0.015-$0.105/sec, speed $0.02-$0.115/sec. Ref video: $0.03-$0.06/sec. Ref img: $0.005/img. Ref audio: $0.0015-$0.0025/sec
- [P-Video-2-Pro](https://inference.sh/apps/pruna/p-video-2-pro.md): $0.01-$0.155/sec; cost: $0.01-$0.105, speed: $0.02-$0.115, quality: $0.04-$0.155 (480p-4k)

## faq

### how much does VACE cost?

$0.40/video. you pay per run from your inference shell credits. no subscription is required.

### how do I run VACE via api?

call pruna/vace with the javascript or python sdk, the rest api, or `belt app run pruna/vace` from a terminal. the api reference on this page lists every input.

### who makes VACE?

VACE is made by pruna and runs on inference shell. every pruna app is listed at https://inference.sh/apps/pruna.

### can my agent use VACE?

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 VACE?

other video apps on inference shell include P-Video-Animate, P-Video-Upscale, P-Video-2-Pro-Avatar, P-Video-2-Pro-Reference. they run through the same api, so switching is a one-line change.