Skip to main content
POST
/
prod-api
/
nebula
/
v4
/
api
/
image2VideoTradition
Image to Video - Traditional Mode - Submit Task
curl --request POST \
  --url https://leapx-hub.com/prod-api/nebula/v4/api/image2VideoTradition \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image2VideoTraditionalDTO.image_urls": {},
  "image2VideoTraditionalDTO.prompt": "<string>",
  "image2VideoTraditionalDTO.duration": "<string>",
  "image2VideoTraditionalDTO.resolution": "<string>",
  "image2VideoTraditionalDTO.req_key": "<string>",
  "image2VideoTraditionalDTO.return_url": true
}
'
{
  "code": 200,
  "msg": "Operation successful",
  "data": {
    "id": "task-1234567890"
  }
}

​
Introduction

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

​
Authentication

​
Authorization
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

​
Request Parameters

​
image2VideoTraditionalDTO.image_urls
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)
​
image2VideoTraditionalDTO.prompt
string
required
Prompt describing desired video effect
​
image2VideoTraditionalDTO.duration
string
required
Video duration, supported values: 3, 5, 8, 10, 12
​
image2VideoTraditionalDTO.resolution
string
required
Video resolution (enum): 480p, 720p, 1080p
​
image2VideoTraditionalDTO.req_key
string
Request key for business correlation or de-duplication
​
image2VideoTraditionalDTO.return_url
boolean
Whether to return the result URL directly (default off)

​
Response Example

{
  "code": 200,
  "msg": "Operation successful",
  "data": {
    "id": "task-1234567890"
  }
}