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

Wanxiang Wan 2.7 image-to-video model supports multimodal inputs (text/image/audio/video) and can perform three major tasks: first-frame video generation, first-and-last-frame video generation, and video continuation. It 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 will only return 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 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="seed" type="integer">
  Random seed used to improve the reproducibility of generated results. Value range: \[0, 2147483647].

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

<ParamField body="prompt" type="string">
  Text prompt used to describe the elements and visual characteristics expected in the generated video. Supports Chinese and English, up to 5000 characters.

  Length limit: 0 - 5000
</ParamField>

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

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

<ParamField body="image_url" type="string" required={true}>
  First-frame image URL. Supported formats: JPEG, JPG, PNG (transparent channels are not supported), BMP, WEBP. Resolution width and height range: \[240, 8000] pixels; aspect ratio: 1:8 to 8:1; file size must not exceed 20 MB. Choose either this or first\_clip\_url; at least one must be provided.
</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="resolution" type="string" default="1080P">
  Output video resolution tier, which affects cost. The video's aspect ratio remains consistent with the input media.

  Options: `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, which can significantly improve generation quality for shorter prompts, but will increase processing time.
</ParamField>

<ParamField body="first_clip_url" type="string">
  URL of the first video clip, used for video continuation. The model will continue generating based on the video content. Supported formats: mp4, mov; duration: 2 to 10 seconds; resolution width and height range: \[240, 4096] pixels; aspect ratio: 1:8 to 8:1; file size must not exceed 100 MB. Choose either this or image\_url.
</ParamField>

<ParamField body="last_frame_url" type="string">
  Last-frame image URL. Used together with the first frame to generate a first-and-last-frame video. Format restrictions are the same as for the first frame.
</ParamField>

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

  Length limit: 0 - 500
</ParamField>

<ParamField body="driving_audio_url" type="string">
  Driving audio URL. When provided, the model will use this audio as the driving source to generate the video (such as lip sync, motion beats, etc.). If not provided, the model will automatically generate matching background music or sound effects. Supported formats: wav, mp3; duration: 2 to 30 seconds; file size must not exceed 15 MB.
</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>
