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

This is an asynchronous API that 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 will only return the async task\_id. 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">
      The text prompt used to describe the elements and visual characteristics expected in the generated video. Chinese and English are supported. Each Chinese character/letter counts as one character, and any excess will be automatically truncated.

      Length limit: 0 - 2000
    </ParamField>

    <ParamField body="img_url" type="string" required={true}>
      The URL or Base64-encoded data of the input image. HTTP or HTTPS protocols are supported. Local files can obtain a temporary URL by uploading the file. Image limits: Image formats: JPEG, JPG, PNG (transparent channels are not supported), BMP, WEBP; Image resolution: The width and height of the image must be in the range \[360, 2000], in pixels; File size: No more than 10MB. Input image instructions: 1. Use a publicly accessible URL - HTTP or HTTPS protocols are supported. Local files can obtain a temporary URL by uploading the file; Example: [https://cdn.translate.alibaba.com/r/wanx-demo-1.png](https://cdn.translate.alibaba.com/r/wanx-demo-1.png). 2. Pass in the string after Base64-encoding the image - Data format: data:{MIME_type};base64,{base64_data}; Example: data:image/png;base64,GDU7MtCZEbTbmRZ...... (the encoded string is too long, so only a snippet is shown). For more information, see input images.
    </ParamField>

    <ParamField body="template" type="string">
      The name of the video effects template. If not filled in, no video effects will be used. Different templates support different effects templates. Please query the video effects list before calling to avoid call failures.
    </ParamField>

    <ParamField body="audio_url" type="string">
      The 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 more 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 extracted 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 sound and the last 2 seconds will be silent.
    </ParamField>

    <ParamField body="negative_prompt" type="string">
      The negative prompt, used to describe content you do not want to see in the video frames and to apply constraints to the video. Chinese and English are supported. The length must not exceed 500 characters, and 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 the reproducibility of generated results, it is recommended to use a fixed seed value. Please note that because model generation is probabilistic, even when using the same seed, it cannot be guaranteed that the generated results will be exactly the same every time.

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

    <ParamField body="audio" type="boolean" default={true}>
      Controls whether to add audio. Parameter priority: audio\_url > audio. This only takes effect when audio\_url is empty. For usage, see audio settings. true: default value, automatically adds audio to the video; false: does not add audio, outputs a silent video.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      The duration of the generated video, in seconds. duration directly affects cost, so please confirm the model pricing before calling. The duration of the generated video, in seconds.

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

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

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

    <ParamField body="watermark" type="boolean" default={false}>
      Whether to add a watermark label. The watermark is located in the lower-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="resolution" type="string" default="1080P">
      Specifies the resolution tier of the generated video. Supports the 720P and 1080P tiers.

      Optional values: `720P`, `1080P`
    </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 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>