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

# Image to Video - Traditional Mode - Submit Task

## Introduction

Submit image-to-video task in traditional mode, used to generate video based on input image.

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g., `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...`
  How to get: Obtain via the POST interface in the Authentication module at the top left, `https://docs.leapx-hub.com/en/leapx-lab-v4/endpoint/get-token`
</ParamField>

## Request Parameters

<ParamField body="image2VideoTraditionalDTO.image_urls" type="array[string]" required>
  Input image URL array:
  0: source image (RGB, 3-channel)
  1: optional mask (grayscale, 1-channel; 0 black = keep, 255 white = remove)
</ParamField>

<ParamField body="image2VideoTraditionalDTO.prompt" type="string" required>
  Prompt describing desired video effect
</ParamField>

<ParamField body="image2VideoTraditionalDTO.duration" type="string" required>
  Video duration, supported values: 3, 5, 8, 10, 12
</ParamField>

<ParamField body="image2VideoTraditionalDTO.resolution" type="string" required>
  Video resolution (enum): 480p, 720p, 1080p
</ParamField>

<ParamField body="image2VideoTraditionalDTO.req_key" type="string">
  Request key for business correlation or de-duplication
</ParamField>

<ParamField body="image2VideoTraditionalDTO.return_url" type="boolean">
  Whether to return the result URL directly (default off)
</ParamField>

### Response Example

<ResponseExample>
  ```json theme={null}
  {
    "code": 200,
    "msg": "Operation successful",
    "data": {
      "id": "task-1234567890"
    }
  }
  ```
</ResponseExample>
