# PixVerse Swap

Edit and transform video with PixVerse Swap 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/pixverse/swap`
- Page: https://spiral.ai/tools/fal/fal-ai/pixverse/swap

## Pricing

Up to $0.52 per run at the default inputs for 60 seconds of input. `resolution`: 360p $0.39, 540p $0.39, 720p (default) $0.52.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- 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 |  | — | URL of the external video to swap |
| `mode` | one of | person, object, background | person | The swap mode to use |
| `keyframe_id` | number (whole) | 1 to … | 1 | The keyframe ID to use for face/object mapping. The input video is normalized to 24 FPS before processing, so keyframe 1 = first frame, keyframe 24 = 1 second in, etc. Valid range: 1 to (duration_seconds * 24). |
| `image_url` (required) | URL or file |  | — | URL of the target image for swapping |
| `resolution` | one of | 360p, 540p, 720p | 720p | The output resolution (1080p not supported) |
| `seed` | number (whole) |  | — | Random seed for generation |
| `original_sound_switch` | true or false |  | true | Whether to keep the original audio |

## 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/pixverse/swap",
    "input": {
      "video_url": "https://v3b.fal.media/files/b/lion/k_RpEIZ4YZtwZklzXz7Gb_output.mp4",
      "image_url": "https://v3b.fal.media/files/b/elephant/Lu7lo2dpxVPD-NrNZzx42_56dc797a1f764c98a4f075a8c0332bf0.jpg"
    }
  }'
```

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

## Common questions

### PixVerse Swap

**How much does PixVerse Swap cost?**

Up to $0.52 per run at the default inputs for 60 seconds of input. `resolution`: 360p $0.39, 540p $0.39, 720p (default) $0.52. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use PixVerse Swap through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/pixverse/swap"` 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 PixVerse Swap?**

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

**Can my AI agent use PixVerse Swap?**

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

