# Wan 2.7 Video Editing - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/model-apis-wan2.7-videoedit

# Wan 2.7 Video Editing

POST

/

v3

/

async

/

wan2.7-videoedit

Wan 2.7 Video Editing

cURL

```
curl --request POST \
--url https://api.novita.ai/v3/async/wan2.7-videoedit \
--header 'Authorization: ' \
--header 'Content-Type: ' \
--data '
{
"seed": 123,
"ratio": "",
"prompt": "",
"duration": 123,
"video_url": "",
"watermark": true,
"resolution": "",
"audio_setting": "",
"prompt_extend": true,
"negative_prompt": "",
"reference_image_url": "",
"reference_image_url_2": "",
"reference_image_url_3": ""
}
'
```

200

```
{
"task_id": ""
}
```

Wan 2.7 Video Editing model with multimodal input support (text/image/video). Capable of instruction-based video editing and video style transfer. Supports 720P and 1080P resolutions, duration 2~10 seconds, billed per second. Output includes audio by default.

This is an asynchronous API; only the task_id will be returned. You should use the task_id to request the [Task Result API](/docs/api-reference/model-apis-task-result) to retrieve the video generation results.

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Supports: `application/json`

[​](#param-authorization)

Authorization

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

##

[​](#request-body)

Request Body

[​](#param-seed)

seed

integer

Random seed for improving reproducibility. Range: [0, 2147483647].Value range: [0, 2147483647]

[​](#param-ratio)

ratio

string

Output video aspect ratio. If not set, uses input video’s aspect ratio. 720P: 16:9(1280720), 9:16(7201280), 1:1(960960), 4:3(1104832), 3:4(8321104). 1080P: 16:9(19201080), 9:16(10801920), 1:1(14401440), 4:3(16481248), 3:4(12481648).Optional values: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`

[​](#param-prompt)

prompt

string

Text prompt describing desired video edits. Supports Chinese and English, max 5000 characters. Examples: ‘Convert the entire scene to clay style’, ‘Replace the girl’s clothes with the ones in the reference image’.Length limit: 0 - 5000

[​](#param-duration)

duration

integer

default:0

Output video duration in seconds. Default 0 means use input video duration without truncation. When set to an integer in [2, 10], the system truncates from the start of the input video to the specified length. Only configure when truncation is needed.Value range: [0, 10]

[​](#param-video-url)

video_url

string

required

Input video URL to be edited. Supported formats: mp4, mov. Duration: 210s, resolution: width and height in [240, 4096] pixels, aspect ratio 1:88:1, max 100MB.

[​](#param-watermark)

watermark

boolean

default:false

Add watermark to the output video (bottom-right corner).

[​](#param-resolution)

resolution

string

default:"1080P"

Output video resolution tier, affects pricing (1080P > 720P). Video aspect ratio matches input unless ratio is specified.Optional values: `720P`, `1080P`

[​](#param-audio-setting)

audio_setting

string

default:"auto"

Audio behavior. ‘auto’: model decides based on prompt content - may regenerate audio if prompt involves sound, otherwise may keep original. ‘origin’: force keep original video audio.Optional values: `auto`, `origin`

[​](#param-prompt-extend)

prompt_extend

boolean

default:true

Enable intelligent prompt rewriting using LLM. Improves generation quality for short prompts but increases processing time.

[​](#param-negative-prompt)

negative_prompt

string

Negative prompt describing undesired content in the output video. Supports Chinese and English, max 500 characters.Length limit: 0 - 500

[​](#param-reference-image-url)

reference_image_url

string

Reference image URL for providing visual reference for editing (e.g., clothing replacement, style transfer). Supported formats: JPEG, JPG, PNG (no transparency), BMP, WEBP. Resolution: [240, 8000] pixels, aspect ratio 1:8~8:1, max 20MB. Up to 3 reference images supported.

[​](#param-reference-image-url-2)

reference_image_url_2

string

Second reference image URL. Same format restrictions as reference_image_url.

[​](#param-reference-image-url-3)

reference_image_url_3

string

Third reference image URL. Same format restrictions as reference_image_url.

##

[​](#response)

Response

[​](#param-task-id)

task_id

string

Use the task_id to request the [Task Result API](/docs/api-reference/model-apis-task-result) to retrieve the generated outputs.

Last modified on April 24, 2026