Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable now

PixVerse Swap

fal-ai/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.

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

Runs
In the background
Returns
video
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

FieldKindDefaultDescription
video_url requiredURL or file—

URL of the external video to swap

modeone of
person, object, background
person

The swap mode to use

keyframe_idnumber (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 requiredURL or file—

URL of the target image for swapping

resolutionone of
360p, 540p, 720p
720p

The output resolution (1080p not supported)

seednumber (whole)—

Random seed for generation

original_sound_switchtrue or falsetrue

Whether to keep the original audio

Same request in code

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"
    }
  }'

Frequently asked questions

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.