> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan 2.7 Video Editing

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.

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

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Supports: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="seed" type="integer">
  Random seed for improving reproducibility. Range: \[0, 2147483647].

  Value range: \[0, 2147483647]
</ParamField>

<ParamField body="ratio" type="string">
  Output video aspect ratio. If not set, uses input video's aspect ratio. 720P: 16:9(1280*720), 9:16(720*1280), 1:1(960*960), 4:3(1104*832), 3:4(832*1104). 1080P: 16:9(1920*1080), 9:16(1080*1920), 1:1(1440*1440), 4:3(1648*1248), 3:4(1248*1648).

  Optional values: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`
</ParamField>

<ParamField body="prompt" type="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
</ParamField>

<ParamField body="duration" type="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]
</ParamField>

<ParamField body="video_url" type="string" required={true}>
  Input video URL to be edited. Supported formats: mp4, mov. Duration: 2~~10s, resolution: width and height in \[240, 4096] pixels, aspect ratio 1:8~~8:1, max 100MB.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Add watermark to the output video (bottom-right corner).
</ParamField>

<ParamField body="resolution" type="string" default="1080P">
  Output video resolution tier, affects pricing (1080P > 720P). Video aspect ratio matches input unless ratio is specified.

  Optional values: `720P`, `1080P`
</ParamField>

<ParamField body="audio_setting" type="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`
</ParamField>

<ParamField body="prompt_extend" type="boolean" default={true}>
  Enable intelligent prompt rewriting using LLM. Improves generation quality for short prompts but increases processing time.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Negative prompt describing undesired content in the output video. Supports Chinese and English, max 500 characters.

  Length limit: 0 - 500
</ParamField>

<ParamField body="reference_image_url" type="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.
</ParamField>

<ParamField body="reference_image_url_2" type="string">
  Second reference image URL. Same format restrictions as reference\_image\_url.
</ParamField>

<ParamField body="reference_image_url_3" type="string">
  Third reference image URL. Same format restrictions as reference\_image\_url.
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={false}>
  Use the task\_id to request the [Task Result API](/api-reference/model-apis-task-result) to retrieve the generated outputs.
</ResponseField>