falVideo to videoComing soon

fal-ai/id-v2v

fal-ai/id-v2v is a video to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Priced by usage

Pricing

$0.26 per second. Measured from the input file. The final charge comes from usage.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
1800s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
prompt requiredtext—The prompt describing the restyled video to generate.
video_url requiredURL or file—URL of the source video whose motion and framing drive the generation.
image_url requiredURL or file—URL of the restyled first frame. The video is regenerated in this frame's identity/style.
keyframesJSON—Optional restyled keyframes pinned at specific output frame indices to anchor identity over long videos.
resolutionone of
480p, 720p
720pOutput resolution tier. Orientation follows the source video (720p is 1280x720 or 720x1280; 480p is 832x480 or 480x832).
num_framesnumber (whole)
17 to 241
81Maximum number of output frames. Capped at the source video's frame count.
segmentation_prompttextpersonText prompt for SAM-3 subject segmentation. The segmented subject's pixels condition the generation; the rest of the frame is regenerated freely.
num_inference_stepsnumber (whole)
2 to 40
30Number of diffusion sampling steps per clip. Higher improves quality but is slower.
guidance_scalenumber
1 to 10
5Classifier-free guidance scale. Controls prompt adherence versus creativity.
vace_scalenumber
0 to 2
1VACE conditioning scale. Controls how strongly the source video's structure constrains the generation.
seednumber (whole)—Random seed for reproducibility. The same seed is used for every clip of a multi-clip generation.

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/id-v2v",
    "input": {
      "prompt": "An astronaut walking through an autumn forest",
      "video_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/mmaudio_input.mp4",
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/ltxv-image-input.jpg"
    }
  }'