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

# Wanxiang Wan 2.7 Text-to-Video

Wanxiang Wan 2.7 text-to-video model generates smooth videos from text prompts. It supports audio-driven generation or automatic dubbing, supports 720P and 1080P resolutions, durations from 2 to 15 seconds, and is billed by the second. Output includes audio by default.

<Tip>
  This is an **asynchronous** API and returns only the asynchronous task's task\_id. You should use this task\_id to request the [Get Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generation result.
</Tip>

## Request Headers

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

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

## Request Body

<ParamField body="seed" type="integer">
  Random seed, used to improve the reproducibility of generation results. Value range: \[0, 2147483647].

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

<ParamField body="size" type="string" default="1920*1080">
  Output video resolution (width*height), which affects cost. 720P tier: 1280*720 (16:9), 720*1280 (9:16), 960*960 (1:1), 1088*832 (4:3), 832*1088 (3:4). 1080P tier: 1920*1080 (16:9), 1080*1920 (9:16), 1440*1440 (1:1), 1632*1248 (4:3), 1248\*1632 (3:4).

  Allowed 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 used to describe the elements and visual characteristics expected in the generated video. Chinese and English are supported, up to 1500 characters. Any excess is automatically truncated.

  Length limit: 0 - 1500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Generated video duration in seconds, billed by the second. An integer in the range \[2, 15].

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

<ParamField body="audio_url" type="string">
  Audio file URL. The model will use this audio to drive video generation (such as lip-syncing, motion beat matching, etc.). If not provided, the model automatically generates matching background music or sound effects. Supported formats: wav and mp3. Duration: 3–30 seconds; file size no more than 15 MB. If the audio exceeds the video duration, it will be clipped; if it is shorter, the remaining part will be silent.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Whether to add a watermark identifier. The watermark is located in the lower-right corner of the video.
</ParamField>

<ParamField body="prompt_extend" type="boolean" default={true}>
  Whether to enable intelligent prompt rewriting. When enabled, a large model is used to intelligently rewrite the input prompt. This significantly improves generation quality for shorter prompts, but increases processing time.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Negative prompt, used to describe content that you do not want to appear in the video frames. Chinese and English are supported, up to 500 characters.

  Length limit: 0 - 500
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={false}>
  Use task\_id to request the [Get Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated output.
</ResponseField>