> ## 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.

# Wan 2.6 Text-to-Video

This is an asynchronous API and only returns an async task\_id. You need to use the task\_id to call the task result query API to obtain the video generation result.

<Tip>
  This is an **asynchronous** API and only returns the task\_id of the async task. You should use this task\_id to request the [Query Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated 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="input" type="object" required={true}>
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={true}>
      Text prompt used to describe the desired elements and visual characteristics in the generated video. Chinese and English are supported. Each Chinese character/letter counts as one character; any excess will be automatically truncated.

      Length limit: 0 - 2000
    </ParamField>

    <ParamField body="audio_url" type="string">
      Audio file URL. The model will use this audio to generate the video. HTTP or HTTPS protocols are supported. Audio limits: format must be wav or mp3; duration 3–30s; file size no larger than 15MB. Handling for exceeding limits: if the audio length exceeds the duration value (5 seconds or 10 seconds), the first 5 seconds or 10 seconds will be automatically used and the rest discarded. If the audio length is shorter than the video duration, the portion beyond the audio length will be silent video. For example, if the audio is 3 seconds and the video duration is 5 seconds, the first 3 seconds of the output video will have audio and the last 2 seconds will be silent.
    </ParamField>

    <ParamField body="negative_prompt" type="string">
      Negative prompt, used to describe content you do not want to see in the video frames and to constrain the video visuals. Chinese and English are supported, with a maximum length of 500 characters; any excess will be automatically truncated.

      Length limit: 0 - 500
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object">
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="seed" type="integer">
      Random seed. The value range is \[0, 2147483647]. If not specified, the system automatically generates a random seed. To improve reproducibility of generated results, it is recommended to fix the seed value. Please note that because model generation is probabilistic, using the same seed still does not guarantee completely identical results every time.

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

    <ParamField body="size" type="string" default="1920*1080">
      Specifies the resolution of the generated video, in the format width*height. Supports 720P tiers (1280*720/720*1280/960*960/1088*832/832*1088) and 1080P tiers (1920*1080/1080*1920/1440*1440/1632*1248/1248\*1632).

      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="audio" type="boolean" default={true}>
      Whether to add audio. Parameter priority: audio\_url > audio. This only takes effect when audio\_url is empty. true: default value, automatically adds audio to the video; false: does not add audio, outputting a silent video.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duration of the generated video, in seconds. Available values are 5, 10, and 15, with a default value of 5. duration directly affects the cost: cost = unit price (based on resolution) × duration (seconds). Please confirm the model pricing before calling.

      Allowed values: `5`, `10`, `15`
    </ParamField>

    <ParamField body="shot_type" type="string" default="multi">
      Video generation mode. single: single-shot generation; multi: multi-shot generation.

      Allowed values: `single`, `multi`
    </ParamField>

    <ParamField body="watermark" type="boolean" default={false}>
      Whether to add a watermark label. The watermark is located in the bottom-right corner of the video, with the fixed text "AI Generated". false: default value, no watermark is added; true: add a watermark.
    </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 results for shorter prompts, but increases processing time. true: default value, enable intelligent rewriting; false: do not enable intelligent rewriting.
    </ParamField>
  </Expandable>
</ParamField>

## Response Information

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