# kwaivgi/kling-v4.0/video-edit

> Kling V4.0 Video Edit rewrites a 3 to 30 second video from a text instruction: it keeps the scene, subject and motion and changes what you describe, with optional reference images and audios, 720p and 1080p output and new synchronized audio generated by default (the original sound can be kept instead). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

## Overview

- **Endpoint**: `https://api.wavespeed.ai/api/v3/kwaivgi/kling-v4.0/video-edit`
- **Polling/result URL**: `https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result`
- **Model ID**: `kwaivgi/kling-v4.0/video-edit`
- **Category**: video-to-video

## Pricing

Charged based on the requested duration and source video length.

**Billed seconds = requested duration + the longer of the requested and source durations.**

Source duration is rounded up to whole seconds, capped at 30 seconds, and used when `duration` is omitted. Sources shorter than 3 seconds are billed as 3 seconds. 1080p costs more than 720p.

**When `duration` is omitted (output follows the source video):**

| Source video length (`video`) | 720p (`resolution=720p`) | 1080p (`resolution=1080p`) |
|-------------------------------|-------------------------:|---------------------------:|
| 3 s or shorter | ~~$0.564~~ $0.4794 | ~~$0.846~~ $0.7191 |
| 5 s | ~~$0.94~~ $0.799 | ~~$1.41~~ $1.1985 |
| 10 s | ~~$1.88~~ $1.598 | ~~$2.82~~ $2.397 |
| 20 s | ~~$3.76~~ $3.196 | ~~$5.64~~ $4.794 |
| 30 s or longer | ~~$5.64~~ $4.794 | ~~$8.46~~ $7.191 |

**When you set `duration` (source video of 5 seconds):**

| Requested duration (`duration`) | 720p (`resolution=720p`) | 1080p (`resolution=1080p`) |
|---------------------------------|-------------------------:|---------------------------:|
| 3 s | ~~$0.752~~ $0.6392 | ~~$1.128~~ $0.9588 |
| 5 s | ~~$0.94~~ $0.799 | ~~$1.41~~ $1.1985 |
| 10 s | ~~$1.88~~ $1.598 | ~~$2.82~~ $2.397 |
| 20 s | ~~$3.76~~ $3.196 | ~~$5.64~~ $4.794 |
| 30 s | ~~$5.64~~ $4.794 | ~~$8.46~~ $7.191 |

Default settings (720p, `duration` omitted) with a 5-second source cost ~~$0.94~~ $0.799 per run.

Reference images, reference audios, aspect ratio, and audio settings add no extra charge.

---

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
The API is asynchronous: submit a prediction, then poll its result URL until it completes.

### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Describe the edit you want applied to the video - change a subject, the setting, the weather or the style. Refer to the video as @Video1, to reference images as @Image1, @Image2, ... and to reference audios as @Audio1, @Audio2, ... in array order.

- **`video`** (`string`, _required_):
  URL of the video to edit. The edit keeps its scene, subject and motion; 3-30 seconds, longer videos are trimmed to 30 seconds.

- **`images`** (`array of string`, _optional_):
  Optional reference images (up to 10) for a subject, object or style to bring into the edit.

- **`audios`** (`array of string`, _optional_):
  Reference audios (up to 3), 5-30 seconds each. They guide the voice and sound of the video.

- **`keep_original_sound`** (`boolean`, _optional_):
  Keep the input video's own sound instead of generating new synchronized audio.
  - Default: `false`

- **`resolution`** (`string`, _optional_):
  Output resolution.
  - Default: `"720p"`
  - Options: "720p", "1080p"

- **`duration`** (`integer`, _optional_):
  Output duration in seconds (3-30). Follows the input video's length if not specified.
  - Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

- **`aspect_ratio`** (`string`, _optional_):
  Aspect ratio of the output video. Follows the input video if not specified.
  - Options: "16:9", "9:16", "1:1", "21:9"



**Required Parameters Example**:

```json
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
}
```

**Full Example**:

```json
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
  "images": [],
  "audios": [],
  "keep_original_sound": false,
  "resolution": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
```

### Result Data Schema

The `data` object returned by the API has the following fields:

- **`created_at`** (`string (date-time)`, _optional_):
  ISO timestamp of when the request was created (e.g., "2023-04-01T12:34:56.789Z").

- **`id`** (`string`, _optional_):
  Unique identifier for the prediction, the ID of the prediction to get.

- **`model`** (`string`, _optional_):
  Model ID used for the prediction.

- **`outputs`** (`array of string | object`, _optional_):
  Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.

- **`status`** (`string`, _optional_):
  Status of the task: created, processing, completed, or failed.

- **`urls`** (`object`, _optional_):
  Object containing related API endpoints.



**Example `data` Object**:

```json
{
  "created_at": "example",
  "id": "example",
  "model": "example",
  "outputs": [],
  "status": "example",
  "urls": {}
}
```

## Usage Examples

The examples use `jq` to read JSON. Set your API key first:

```bash
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
```

### 1. Submit a prediction

```bash
REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url https://api.wavespeed.ai/api/v3/kwaivgi/kling-v4.0/video-edit \
  --header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  --header "Content-Type: application/json" \
  --data "${REQUEST_BODY}")

printf '%s\n' "${SUBMIT_RESPONSE}" | jq .
```

The response contains the prediction ID in `data.id`.

### 2. Poll until complete and read `outputs`

```bash
PREDICTION_ID=$(printf '%s' "${SUBMIT_RESPONSE}" | jq -r '.data.id')
if [ -z "${PREDICTION_ID}" ] || [ "${PREDICTION_ID}" = "null" ]; then
  printf 'Submission response did not contain data.id\n' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    --request GET \
    --url "${RESULT_URL}" \
    --header "Authorization: Bearer ${WAVESPEED_API_KEY}")

  RESULT=$(printf '%s' "${RESPONSE}" | jq -e '.data')
  STATUS=$(printf '%s' "${RESULT}" | jq -er '.status')
  case "${STATUS}" in
    completed)
      # Generated files are returned in the outputs array.
      printf '%s\n' "${RESULT}" | jq '.outputs'
      break
      ;;
    failed|cancelled|timeout|deleted)
      printf '%s\n' "${RESULT}" | jq '{status, error, code}'
      exit 1
      ;;
    *)
      sleep 2
      ;;
  esac
done
```

## Additional Resources

### Documentation

- [Model Playground](https://wavespeed.ai/models/kwaivgi/kling-v4.0/video-edit)
- [API Documentation](https://wavespeed.ai/docs/docs-api/kwaivgi/kwaivgi-kling-v4.0-video-edit)
