# PixVerse

> PixVerse Extend model is a video extending tool for your videos using with high-quality video extending techniques 


## Overview

- **Endpoint**: `https://fal.run/fal-ai/pixverse/extend/fast`
- **Model ID**: `fal-ai/pixverse/extend/fast`
- **Category**: video-to-video
- **Kind**: inference
**Tags**: utility, editing



## Pricing

For **5s video** your request will cost **0.3$ for 360p and 540p, 0.4$ for 720p and 0.8$ for 1080p**. For **$1** you can run this model with **approximately 2 times**.

For more details, see [fal.ai pricing](https://fal.ai/pricing).

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:


- **`video_url`** (`string`, _required_):
  URL of the input video to extend
  - Examples: "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4"

- **`prompt`** (`string`, _required_):
  Prompt describing how to extend the video
  - Examples: "A kid is talking into camera"

- **`negative_prompt`** (`string`, _optional_):
  Negative prompt to be used for the generation Default value: `""`
  - Default: `""`

- **`style`** (`Enum`, _optional_):
  The style of the extended video
  - Options: `"anime"`, `"3d_animation"`, `"clay"`, `"comic"`, `"cyberpunk"`

- **`resolution`** (`ResolutionEnum`, _optional_):
  The resolution of the generated video. Fast mode doesn't support 1080p Default value: `"720p"`
  - Default: `"720p"`
  - Options: `"360p"`, `"540p"`, `"720p"`

- **`model`** (`ModelEnum`, _optional_):
  The model version to use for generation Default value: `"v4.5"`
  - Default: `"v4.5"`
  - Options: `"v3.5"`, `"v4"`, `"v4.5"`, `"v5"`, `"v5.5"`, `"v5.6"`, `"v6"`

- **`seed`** (`integer`, _optional_):
  Random seed for generation

- **`generate_audio_switch`** (`boolean`, _optional_):
  Enable audio generation (BGM, SFX, dialogue). Supported in v5.6+ models.
  - Default: `false`



**Required Parameters Example**:

```json
{
  "video_url": "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
  "prompt": "A kid is talking into camera"
}
```

**Full Example**:

```json
{
  "video_url": "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
  "prompt": "A kid is talking into camera",
  "resolution": "720p",
  "model": "v4.5"
}
```


### Output Schema

The API returns the following output format:

- **`video`** (`File`, _required_):
  The extended video
  - Examples: {"url":"https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4","file_name":"output.mp4","content_type":"video/mp4","file_size":1163040}



**Example Response**:

```json
{
  "video": {
    "url": "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
    "file_name": "output.mp4",
    "content_type": "video/mp4",
    "file_size": 1163040
  }
}
```


## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://fal.run/fal-ai/pixverse/extend/fast \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
     "video_url": "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
     "prompt": "A kid is talking into camera"
   }'
```

### Python

Ensure you have the Python client installed:

```bash
pip install fal-client
```

Then use the API client to make requests:

```python
import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/pixverse/extend/fast",
    arguments={
        "video_url": "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
        "prompt": "A kid is talking into camera"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)
```

### JavaScript

Ensure you have the JavaScript client installed:

```bash
npm install --save @fal-ai/client
```

Then use the API client to make requests:

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/pixverse/extend/fast", {
  input: {
    video_url: "https://v3.fal.media/files/rabbit/88-jI3VWXU4Q8kSNrWo3c_output.mp4",
    prompt: "A kid is talking into camera"
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);
```


## Additional Resources

### Documentation

- [Model Playground](https://fal.ai/models/fal-ai/pixverse/extend/fast)
- [API Documentation](https://fal.ai/models/fal-ai/pixverse/extend/fast/api)
- [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/pixverse/extend/fast)

### fal.ai Platform

- [Platform Documentation](https://docs.fal.ai)
- [Python Client](https://docs.fal.ai/clients/python)
- [JavaScript Client](https://docs.fal.ai/clients/javascript)
