> ## 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 Text-to-Video

Wan 2.7 Text-to-Video model generates smooth videos from text prompts. Supports audio-driven generation or automatic soundtrack. 720P and 1080P resolutions, duration 2\~15 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**](/docs/nl/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="size" type="string" default="1920*1080">
  Output video resolution (width*height), affects pricing. 720P: 1280*720 (16:9), 720*1280 (9:16), 960*960 (1:1), 1088*832 (4:3), 832*1088 (3:4). 1080P: 1920*1080 (16:9), 1080*1920 (9:16), 1440*1440 (1:1), 1632*1248 (4:3), 1248\*1632 (3:4).

  Optional values: `1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088`, `1920*1080`, `1080*1920`, `1440*1440`, `1632*1248`, `1248*1632`
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text prompt describing desired video content. Supports Chinese and English, max 1500 characters. Exceeding portion is automatically truncated.

  Length limit: 0 - 1500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Video duration in seconds, billed per second. Range: \[2, 15] integer.

  Value range: \[2, 15]
</ParamField>

<ParamField body="audio_url" type="string">
  Audio file URL. Model will use this audio to drive video generation (lip-sync, beat-matching, etc.). If not provided, model auto-generates matching background music or sound effects. Formats: wav, mp3. Duration: 3\~30s. Max size: 15MB. If audio exceeds video duration it is truncated; if shorter, remaining video is silent.
</ParamField>

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

<ParamField body="prompt_extend" type="boolean" default={true}>
  Enable intelligent prompt rewriting. Uses a language model to enhance short prompts, improving generation quality at the cost of slightly longer processing time.
</ParamField>

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

  Length limit: 0 - 500
</ParamField>

## Response

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