Kling 4.0 Video Edit
kling/v4/video-to-video/editEdit and transform video with Kling 4.0 Video Edit from fal through one Spiral API key. Kling 4.0 edits an input video using text instructions and optional image references, producing 3 to 30-second videos at 720p or 1080p. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.183 per second of source plus output at 1080p ($0.122 at 720p), at least twice the output's length.
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
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Edit instruction. Reference the source video as @Video1. |
video_url required | URL or file | — | The video to edit (3-30s), referenced as @Video1. Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 30.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s |
image_urls | URLs or files | — | Reference images, referenced as @Image1, @Image2, ... |
elements | JSON | — | Characters/objects, referenced as @Element1, @Element2, ... |
duration | number (whole) 3 to 30 | — | Output duration in seconds (3-30). Defaults to the source video's length. |
resolution | one of 720p, 1080p | 1080p | Output resolution. |
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": "kling/v4/video-to-video/edit",
"input": {
"prompt": "Change the background to a tropical island at sunset.",
"video_url": "<video_url>"
}
}'Frequently asked questions
How much does Kling 4.0 Video Edit cost?
$0.183 per second of source plus output at 1080p ($0.122 at 720p), at least twice the output's length. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Kling 4.0 Video Edit through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "kling/v4/video-to-video/edit"` 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 4.0 Video Edit?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Kling 4.0 Video Edit?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.