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

falVideoAvailable nowReleased 2026-03-05

Kling 3.0 Pro · Motion Control

fal-ai/kling-video/v3/pro/motion-control

Edit and transform video with Kling 3.0 Pro · Motion Control from fal through one Spiral API key. Animates a person in an image with the moves of a reference video; the character needs a visible human upper body, so no animals. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

$0.2184 per second.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Longest input media
31 seconds
Largest output
5 GB

Input

FieldKindDefaultDescription
prompttext—
image_url requiredURL or file—

Reference image URL. The characters, backgrounds, and other elements in the generated video are based on this reference image. Characters should have clear body proportions, avoid occlusion, and occupy more than 5% of the image area.

video_url requiredURL or file—

Reference video URL. The character actions in the generated video will be consistent with this reference video. Should contain a realistic style character with entire body or upper body visible, including head, without obstruction. Duration limit depends on character_orientation: 10s max for 'image', 30s max for 'video'.

keep_original_soundtrue or falsetrue

Whether to keep the original sound from the reference video.

character_orientation requiredone of
image, video
—

Controls whether the output character's orientation matches the reference image or video. 'video': orientation matches reference video - better for complex motions (max 30s). 'image': orientation matches reference image - better for following camera movements (max 10s).

elementsJSON—

Optional element for facial consistency binding. Upload a facial element to enhance identity preservation in the generated video. Only 1 element is supported. Reference in prompt as @Element1. Element binding is only supported when character_orientation is 'video'.

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/kling-video/v3/pro/motion-control",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/0a90ffa7/TNErq9yD7ZxGRATjfAqnh_EIgJSN67.png",
      "video_url": "https://v3b.fal.media/files/b/0a90ff92/hklvF__w53diz6Rve7f5__JuDW2xl0mr6sJ_Kjz3Vxe_vidoeook%20(1)_1.mp4",
      "character_orientation": "image"
    }
  }'

Frequently asked questions

How much does Kling 3.0 Pro · Motion Control cost?

$0.2184 per second. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Kling 3.0 Pro · Motion Control through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/kling-video/v3/pro/motion-control"` 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 Kling 3.0 Pro · Motion Control?

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

Can my AI agent use Kling 3.0 Pro · Motion Control?

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